From 532dd4e1fc85c2b05090cc27a143a495cded4a4b Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 17 Nov 2025 00:08:20 +0000 Subject: [PATCH 01/55] npm(deps): bump default-browser-id from 5.0.0 to 5.0.1 Bumps [default-browser-id](https://github.com/sindresorhus/default-browser-id) from 5.0.0 to 5.0.1. - [Release notes](https://github.com/sindresorhus/default-browser-id/releases) - [Commits](https://github.com/sindresorhus/default-browser-id/compare/v5.0.0...v5.0.1) --- updated-dependencies: - dependency-name: default-browser-id dependency-version: 5.0.1 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 676b037f4..50580bdd2 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1127,9 +1127,9 @@ } }, "node_modules/default-browser-id": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.0.tgz", - "integrity": "sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA==", + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", + "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==", "engines": { "node": ">=18" }, @@ -4227,9 +4227,9 @@ } }, "default-browser-id": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.0.tgz", - "integrity": "sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA==" + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", + "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==" }, "define-lazy-prop": { "version": "3.0.0", From 33b9468435622915775538d548477c00f066ed17 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 26 Nov 2025 00:04:01 +0000 Subject: [PATCH 02/55] npm(deps): bump default-browser-id from 5.0.0 to 5.0.1 Bumps [default-browser-id](https://github.com/sindresorhus/default-browser-id) from 5.0.0 to 5.0.1. - [Release notes](https://github.com/sindresorhus/default-browser-id/releases) - [Commits](https://github.com/sindresorhus/default-browser-id/compare/v5.0.0...v5.0.1) --- updated-dependencies: - dependency-name: default-browser-id dependency-version: 5.0.1 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 676b037f4..50580bdd2 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1127,9 +1127,9 @@ } }, "node_modules/default-browser-id": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.0.tgz", - "integrity": "sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA==", + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", + "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==", "engines": { "node": ">=18" }, @@ -4227,9 +4227,9 @@ } }, "default-browser-id": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.0.tgz", - "integrity": "sha512-A6p/pu/6fyBcA1TRz/GqWYPViplrftcW2gZC9q79ngNCKAeR/X3gcEdXQHl4KNXV+3wgIJ1CPkJQ3IHM6lcsyA==" + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", + "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==" }, "define-lazy-prop": { "version": "3.0.0", From fcc2d1df55a990a79ae37aff931627751d735df1 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:03:52 +0000 Subject: [PATCH 03/55] sandbox-npm(deps): bump @hapi/cryptiles from 6.0.1 to 6.0.3 in /sandbox Bumps [@hapi/cryptiles](https://github.com/hapijs/cryptiles) from 6.0.1 to 6.0.3. - [Commits](https://github.com/hapijs/cryptiles/compare/v6.0.1...v6.0.3) --- updated-dependencies: - dependency-name: "@hapi/cryptiles" dependency-version: 6.0.3 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index f8d535bbd..5c0dba643 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -238,9 +238,9 @@ } }, "node_modules/@hapi/cryptiles": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.1.tgz", - "integrity": "sha512-9GM9ECEHfR8lk5ASOKG4+4ZsEzFqLfhiryIJ2ISePVB92OHLp/yne4m+zn7z9dgvM98TLpiFebjDFQ0UHcqxXQ==", + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.3.tgz", + "integrity": "sha512-r6VKalpbMHz4ci3gFjFysBmhwCg70RpYZy6OkjEpdXzAYnYFX5XsW7n4YMJvuIYpnMwLxGUjK/cBhA7X3JDvXw==", "dependencies": { "@hapi/boom": "^10.0.1" }, @@ -1550,9 +1550,9 @@ } }, "@hapi/cryptiles": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.1.tgz", - "integrity": "sha512-9GM9ECEHfR8lk5ASOKG4+4ZsEzFqLfhiryIJ2ISePVB92OHLp/yne4m+zn7z9dgvM98TLpiFebjDFQ0UHcqxXQ==", + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.3.tgz", + "integrity": "sha512-r6VKalpbMHz4ci3gFjFysBmhwCg70RpYZy6OkjEpdXzAYnYFX5XsW7n4YMJvuIYpnMwLxGUjK/cBhA7X3JDvXw==", "requires": { "@hapi/boom": "^10.0.1" } From a103c2f67e4a1279a70107d42a8e6b08777027b2 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:03:53 +0000 Subject: [PATCH 04/55] npm(deps): bump form-data from 4.0.4 to 4.0.5 Bumps [form-data](https://github.com/form-data/form-data) from 4.0.4 to 4.0.5. - [Release notes](https://github.com/form-data/form-data/releases) - [Changelog](https://github.com/form-data/form-data/blob/master/CHANGELOG.md) - [Commits](https://github.com/form-data/form-data/compare/v4.0.4...v4.0.5) --- updated-dependencies: - dependency-name: form-data dependency-version: 4.0.5 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 15fbe7044..2c4a1f644 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1355,9 +1355,9 @@ "license": "MIT" }, "node_modules/form-data": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz", - "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==", + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", + "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", @@ -4377,9 +4377,9 @@ "integrity": "sha512-k6GAGDyqLe9JaebCsFCoudPPWfihKu8pylYXRlqP1J7ms39iPoTtk2fviNglIeQEwdh0bQeKJ01ZPyuyQvKzwg==" }, "form-data": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz", - "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==", + "version": "4.0.5", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", + "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", "requires": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", From 9316a6b88621486399c59fbe7cb011e6d9e9bbc9 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:03:53 +0000 Subject: [PATCH 05/55] sandbox-npm(deps-dev): bump @eslint/eslintrc in /sandbox Bumps [@eslint/eslintrc](https://github.com/eslint/eslintrc) from 3.3.1 to 3.3.3. - [Release notes](https://github.com/eslint/eslintrc/releases) - [Changelog](https://github.com/eslint/eslintrc/blob/main/CHANGELOG.md) - [Commits](https://github.com/eslint/eslintrc/compare/v3.3.1...eslintrc-v3.3.3) --- updated-dependencies: - dependency-name: "@eslint/eslintrc" dependency-version: 3.3.3 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index f8d535bbd..dae0a8845 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -84,11 +84,10 @@ } }, "node_modules/@eslint/eslintrc": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz", - "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==", + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", + "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", "dev": true, - "license": "MIT", "dependencies": { "ajv": "^6.12.4", "debug": "^4.3.2", @@ -96,7 +95,7 @@ "globals": "^14.0.0", "ignore": "^5.2.0", "import-fresh": "^3.2.1", - "js-yaml": "^4.1.0", + "js-yaml": "^4.1.1", "minimatch": "^3.1.2", "strip-json-comments": "^3.1.1" }, @@ -1419,9 +1418,9 @@ } }, "@eslint/eslintrc": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz", - "integrity": "sha512-gtF186CXhIl1p4pJNGZw8Yc6RlshoePRvE0X91oPGb3vZ8pM3qOS9W9NGPat9LziaBV7XrJWGylNQXkGcnM3IQ==", + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", + "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", "dev": true, "requires": { "ajv": "^6.12.4", @@ -1430,7 +1429,7 @@ "globals": "^14.0.0", "ignore": "^5.2.0", "import-fresh": "^3.2.1", - "js-yaml": "^4.1.0", + "js-yaml": "^4.1.1", "minimatch": "^3.1.2", "strip-json-comments": "^3.1.1" }, From ada559b993c47372e51d786328e9c806bded0151 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:04:11 +0000 Subject: [PATCH 06/55] pip(deps): bump exceptiongroup from 1.3.0 to 1.3.1 Bumps [exceptiongroup](https://github.com/agronholm/exceptiongroup) from 1.3.0 to 1.3.1. - [Release notes](https://github.com/agronholm/exceptiongroup/releases) - [Changelog](https://github.com/agronholm/exceptiongroup/blob/main/CHANGES.rst) - [Commits](https://github.com/agronholm/exceptiongroup/compare/1.3.0...1.3.1) --- updated-dependencies: - dependency-name: exceptiongroup dependency-version: 1.3.1 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- poetry.lock | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/poetry.lock b/poetry.lock index 6f54b615f..73e2d22b5 100644 --- a/poetry.lock +++ b/poetry.lock @@ -468,15 +468,14 @@ files = [ [[package]] name = "exceptiongroup" -version = "1.3.0" +version = "1.3.1" description = "Backport of PEP 654 (exception groups)" optional = false python-versions = ">=3.7" groups = ["main", "dev"] -markers = "python_version == \"3.10\"" files = [ - {file = "exceptiongroup-1.3.0-py3-none-any.whl", hash = "sha256:4d111e6e0c13d0644cad6ddaa7ed0261a0b36971f6d23e7ec9b4b9097da78a10"}, - {file = "exceptiongroup-1.3.0.tar.gz", hash = "sha256:b241f5885f560bc56a59ee63ca4c6a8bfa46ae4ad651af316d4e81817bb9fd88"}, + {file = "exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598"}, + {file = "exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219"}, ] [package.dependencies] From 6f4bca7c7977a51168b24879bd52c2270418fa69 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:04:13 +0000 Subject: [PATCH 07/55] pip(deps): bump pytest-check from 2.6.0 to 2.6.2 Bumps [pytest-check](https://github.com/okken/pytest-check) from 2.6.0 to 2.6.2. - [Release notes](https://github.com/okken/pytest-check/releases) - [Changelog](https://github.com/okken/pytest-check/blob/main/changelog.md) - [Commits](https://github.com/okken/pytest-check/compare/2.6.0...2.6.2) --- updated-dependencies: - dependency-name: pytest-check dependency-version: 2.6.2 dependency-type: direct:production update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- poetry.lock | 8 ++++---- pyproject.toml | 2 +- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/poetry.lock b/poetry.lock index 6f54b615f..25c8bb008 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1522,14 +1522,14 @@ testing = ["coverage (>=6.2)", "hypothesis (>=5.7.1)"] [[package]] name = "pytest-check" -version = "2.6.0" +version = "2.6.2" description = "A pytest plugin that allows multiple failures per test." optional = false python-versions = ">=3.9" groups = ["main"] files = [ - {file = "pytest_check-2.6.0-py3-none-any.whl", hash = "sha256:a9735020dc0f0219b8a5298d7f90cf6d1f6fe34b709b9ecbb9e0f49393ebab38"}, - {file = "pytest_check-2.6.0.tar.gz", hash = "sha256:9be4c59a09827129109148c85d7b5964b57f0a5ced1b619459ca30e6f463ca42"}, + {file = "pytest_check-2.6.2-py3-none-any.whl", hash = "sha256:71762eb58f6b8a2d75afb9e6c8b800af7f634f67359d899a65ee48aaee087215"}, + {file = "pytest_check-2.6.2.tar.gz", hash = "sha256:5e2128405b14978ad74f21f3225fcc52bbb1cc7c41a55d5eaad9f1e3cd27e42e"}, ] [package.dependencies] @@ -2064,4 +2064,4 @@ files = [ [metadata] lock-version = "2.1" python-versions = "^3.10" -content-hash = "5ae05ff40ea9bec8144357276aa1506ab405b7ef9dab3ee0001edddb2cc7bc43" +content-hash = "69013524ffd423a37c916a93117bc50fa2413c9be5c404ff936a83d0c63f1e36" diff --git a/pyproject.toml b/pyproject.toml index 0125e5247..6a37dd641 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -28,7 +28,7 @@ semver = "^3.0.4" gitpython = "^3.1.45" lxml = "^4.9.4" xmlformatter = "^0.2.8" -pytest-check = "^2.6.0" +pytest-check = "^2.6.2" requests = "^2.32.5" openapi-core = "^0.19.5" From d2498ae0f9f34e5254a7fdaf515e9214ed3a2ef5 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:04:15 +0000 Subject: [PATCH 08/55] pip(deps-dev): bump pydantic from 2.12.4 to 2.12.5 Bumps [pydantic](https://github.com/pydantic/pydantic) from 2.12.4 to 2.12.5. - [Release notes](https://github.com/pydantic/pydantic/releases) - [Changelog](https://github.com/pydantic/pydantic/blob/v2.12.5/HISTORY.md) - [Commits](https://github.com/pydantic/pydantic/compare/v2.12.4...v2.12.5) --- updated-dependencies: - dependency-name: pydantic dependency-version: 2.12.5 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- poetry.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/poetry.lock b/poetry.lock index 6f54b615f..9a003f88a 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1237,14 +1237,14 @@ files = [ [[package]] name = "pydantic" -version = "2.12.4" +version = "2.12.5" description = "Data validation using Python type hints" optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "pydantic-2.12.4-py3-none-any.whl", hash = "sha256:92d3d202a745d46f9be6df459ac5a064fdaa3c1c4cd8adcfa332ccf3c05f871e"}, - {file = "pydantic-2.12.4.tar.gz", hash = "sha256:0f8cb9555000a4b5b617f66bfd2566264c4984b27589d3b845685983e8ea85ac"}, + {file = "pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d"}, + {file = "pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49"}, ] [package.dependencies] From e5d9458059f39c6dd566878e55e4dfcad6b7fad5 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:04:16 +0000 Subject: [PATCH 09/55] pip(deps): bump rpds-py from 0.29.0 to 0.30.0 Bumps [rpds-py](https://github.com/crate-py/rpds) from 0.29.0 to 0.30.0. - [Release notes](https://github.com/crate-py/rpds/releases) - [Commits](https://github.com/crate-py/rpds/compare/v0.29.0...v0.30.0) --- updated-dependencies: - dependency-name: rpds-py dependency-version: 0.30.0 dependency-type: indirect update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- poetry.lock | 232 ++++++++++++++++++++++++++-------------------------- 1 file changed, 116 insertions(+), 116 deletions(-) diff --git a/poetry.lock b/poetry.lock index 6f54b615f..7421098e6 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1735,127 +1735,127 @@ six = "*" [[package]] name = "rpds-py" -version = "0.29.0" +version = "0.30.0" description = "Python bindings to Rust's persistent data structures (rpds)" optional = false python-versions = ">=3.10" groups = ["main"] files = [ - {file = "rpds_py-0.29.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:4ae4b88c6617e1b9e5038ab3fccd7bac0842fdda2b703117b2aa99bc85379113"}, - {file = "rpds_py-0.29.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:7d9128ec9d8cecda6f044001fde4fb71ea7c24325336612ef8179091eb9596b9"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:d37812c3da8e06f2bb35b3cf10e4a7b68e776a706c13058997238762b4e07f4f"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:66786c3fb1d8de416a7fa8e1cb1ec6ba0a745b2b0eee42f9b7daa26f1a495545"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:b58f5c77f1af888b5fd1876c9a0d9858f6f88a39c9dd7c073a88e57e577da66d"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:799156ef1f3529ed82c36eb012b5d7a4cf4b6ef556dd7cc192148991d07206ae"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:453783477aa4f2d9104c4b59b08c871431647cb7af51b549bbf2d9eb9c827756"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:24a7231493e3c4a4b30138b50cca089a598e52c34cf60b2f35cebf62f274fdea"}, - {file = "rpds_py-0.29.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:7033c1010b1f57bb44d8067e8c25aa6fa2e944dbf46ccc8c92b25043839c3fd2"}, - {file = "rpds_py-0.29.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:0248b19405422573621172ab8e3a1f29141362d13d9f72bafa2e28ea0cdca5a2"}, - {file = "rpds_py-0.29.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:f9f436aee28d13b9ad2c764fc273e0457e37c2e61529a07b928346b219fcde3b"}, - {file = "rpds_py-0.29.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:24a16cb7163933906c62c272de20ea3c228e4542c8c45c1d7dc2b9913e17369a"}, - {file = "rpds_py-0.29.0-cp310-cp310-win32.whl", hash = "sha256:1a409b0310a566bfd1be82119891fefbdce615ccc8aa558aff7835c27988cbef"}, - {file = "rpds_py-0.29.0-cp310-cp310-win_amd64.whl", hash = "sha256:c5523b0009e7c3c1263471b69d8da1c7d41b3ecb4cb62ef72be206b92040a950"}, - {file = "rpds_py-0.29.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:9b9c764a11fd637e0322a488560533112837f5334ffeb48b1be20f6d98a7b437"}, - {file = "rpds_py-0.29.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:3fd2164d73812026ce970d44c3ebd51e019d2a26a4425a5dcbdfa93a34abc383"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:4a097b7f7f7274164566ae90a221fd725363c0e9d243e2e9ed43d195ccc5495c"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:7cdc0490374e31cedefefaa1520d5fe38e82fde8748cbc926e7284574c714d6b"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:89ca2e673ddd5bde9b386da9a0aac0cab0e76f40c8f0aaf0d6311b6bbf2aa311"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a5d9da3ff5af1ca1249b1adb8ef0573b94c76e6ae880ba1852f033bf429d4588"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8238d1d310283e87376c12f658b61e1ee23a14c0e54c7c0ce953efdbdc72deed"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:2d6fb2ad1c36f91c4646989811e84b1ea5e0c3cf9690b826b6e32b7965853a63"}, - {file = "rpds_py-0.29.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:534dc9df211387547267ccdb42253aa30527482acb38dd9b21c5c115d66a96d2"}, - {file = "rpds_py-0.29.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d456e64724a075441e4ed648d7f154dc62e9aabff29bcdf723d0c00e9e1d352f"}, - {file = "rpds_py-0.29.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:a738f2da2f565989401bd6fd0b15990a4d1523c6d7fe83f300b7e7d17212feca"}, - {file = "rpds_py-0.29.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:a110e14508fd26fd2e472bb541f37c209409876ba601cf57e739e87d8a53cf95"}, - {file = "rpds_py-0.29.0-cp311-cp311-win32.whl", hash = "sha256:923248a56dd8d158389a28934f6f69ebf89f218ef96a6b216a9be6861804d3f4"}, - {file = "rpds_py-0.29.0-cp311-cp311-win_amd64.whl", hash = "sha256:539eb77eb043afcc45314d1be09ea6d6cafb3addc73e0547c171c6d636957f60"}, - {file = "rpds_py-0.29.0-cp311-cp311-win_arm64.whl", hash = "sha256:bdb67151ea81fcf02d8f494703fb728d4d34d24556cbff5f417d74f6f5792e7c"}, - {file = "rpds_py-0.29.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a0891cfd8db43e085c0ab93ab7e9b0c8fee84780d436d3b266b113e51e79f954"}, - {file = "rpds_py-0.29.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:3897924d3f9a0361472d884051f9a2460358f9a45b1d85a39a158d2f8f1ad71c"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2a21deb8e0d1571508c6491ce5ea5e25669b1dd4adf1c9d64b6314842f708b5d"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:9efe71687d6427737a0a2de9ca1c0a216510e6cd08925c44162be23ed7bed2d5"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:40f65470919dc189c833e86b2c4bd21bd355f98436a2cef9e0a9a92aebc8e57e"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:def48ff59f181130f1a2cb7c517d16328efac3ec03951cca40c1dc2049747e83"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:ad7bd570be92695d89285a4b373006930715b78d96449f686af422debb4d3949"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:5a572911cd053137bbff8e3a52d31c5d2dba51d3a67ad902629c70185f3f2181"}, - {file = "rpds_py-0.29.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d583d4403bcbf10cffc3ab5cee23d7643fcc960dff85973fd3c2d6c86e8dbb0c"}, - {file = "rpds_py-0.29.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:070befbb868f257d24c3bb350dbd6e2f645e83731f31264b19d7231dd5c396c7"}, - {file = "rpds_py-0.29.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:fc935f6b20b0c9f919a8ff024739174522abd331978f750a74bb68abd117bd19"}, - {file = "rpds_py-0.29.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:8c5a8ecaa44ce2d8d9d20a68a2483a74c07f05d72e94a4dff88906c8807e77b0"}, - {file = "rpds_py-0.29.0-cp312-cp312-win32.whl", hash = "sha256:ba5e1aeaf8dd6d8f6caba1f5539cddda87d511331714b7b5fc908b6cfc3636b7"}, - {file = "rpds_py-0.29.0-cp312-cp312-win_amd64.whl", hash = "sha256:b5f6134faf54b3cb83375db0f113506f8b7770785be1f95a631e7e2892101977"}, - {file = "rpds_py-0.29.0-cp312-cp312-win_arm64.whl", hash = "sha256:b016eddf00dca7944721bf0cd85b6af7f6c4efaf83ee0b37c4133bd39757a8c7"}, - {file = "rpds_py-0.29.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:1585648d0760b88292eecab5181f5651111a69d90eff35d6b78aa32998886a61"}, - {file = "rpds_py-0.29.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:521807963971a23996ddaf764c682b3e46459b3c58ccd79fefbe16718db43154"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0a8896986efaa243ab713c69e6491a4138410f0fe36f2f4c71e18bd5501e8014"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1d24564a700ef41480a984c5ebed62b74e6ce5860429b98b1fede76049e953e6"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:e6596b93c010d386ae46c9fba9bfc9fc5965fa8228edeac51576299182c2e31c"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:5cc58aac218826d054c7da7f95821eba94125d88be673ff44267bb89d12a5866"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:de73e40ebc04dd5d9556f50180395322193a78ec247e637e741c1b954810f295"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:295ce5ac7f0cf69a651ea75c8f76d02a31f98e5698e82a50a5f4d4982fbbae3b"}, - {file = "rpds_py-0.29.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1ea59b23ea931d494459c8338056fe7d93458c0bf3ecc061cd03916505369d55"}, - {file = "rpds_py-0.29.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f49d41559cebd608042fdcf54ba597a4a7555b49ad5c1c0c03e0af82692661cd"}, - {file = "rpds_py-0.29.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:05a2bd42768ea988294ca328206efbcc66e220d2d9b7836ee5712c07ad6340ea"}, - {file = "rpds_py-0.29.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:33ca7bdfedd83339ca55da3a5e1527ee5870d4b8369456b5777b197756f3ca22"}, - {file = "rpds_py-0.29.0-cp313-cp313-win32.whl", hash = "sha256:20c51ae86a0bb9accc9ad4e6cdeec58d5ebb7f1b09dd4466331fc65e1766aae7"}, - {file = "rpds_py-0.29.0-cp313-cp313-win_amd64.whl", hash = "sha256:6410e66f02803600edb0b1889541f4b5cc298a5ccda0ad789cc50ef23b54813e"}, - {file = "rpds_py-0.29.0-cp313-cp313-win_arm64.whl", hash = "sha256:56838e1cd9174dc23c5691ee29f1d1be9eab357f27efef6bded1328b23e1ced2"}, - {file = "rpds_py-0.29.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:37d94eadf764d16b9a04307f2ab1d7af6dc28774bbe0535c9323101e14877b4c"}, - {file = "rpds_py-0.29.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:d472cf73efe5726a067dce63eebe8215b14beabea7c12606fd9994267b3cfe2b"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:72fdfd5ff8992e4636621826371e3ac5f3e3b8323e9d0e48378e9c13c3dac9d0"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:2549d833abdf8275c901313b9e8ff8fba57e50f6a495035a2a4e30621a2f7cc4"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4448dad428f28a6a767c3e3b80cde3446a22a0efbddaa2360f4bb4dc836d0688"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:115f48170fd4296a33938d8c11f697f5f26e0472e43d28f35624764173a60e4d"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8e5bb73ffc029820f4348e9b66b3027493ae00bca6629129cd433fd7a76308ee"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:b1581fcde18fcdf42ea2403a16a6b646f8eb1e58d7f90a0ce693da441f76942e"}, - {file = "rpds_py-0.29.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:16e9da2bda9eb17ea318b4c335ec9ac1818e88922cbe03a5743ea0da9ecf74fb"}, - {file = "rpds_py-0.29.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:28fd300326dd21198f311534bdb6d7e989dd09b3418b3a91d54a0f384c700967"}, - {file = "rpds_py-0.29.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:2aba991e041d031c7939e1358f583ae405a7bf04804ca806b97a5c0e0af1ea5e"}, - {file = "rpds_py-0.29.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:7f437026dbbc3f08c99cc41a5b2570c6e1a1ddbe48ab19a9b814254128d4ea7a"}, - {file = "rpds_py-0.29.0-cp313-cp313t-win32.whl", hash = "sha256:6e97846e9800a5d0fe7be4d008f0c93d0feeb2700da7b1f7528dabafb31dfadb"}, - {file = "rpds_py-0.29.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f49196aec7c4b406495f60e6f947ad71f317a765f956d74bbd83996b9edc0352"}, - {file = "rpds_py-0.29.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:394d27e4453d3b4d82bb85665dc1fcf4b0badc30fc84282defed71643b50e1a1"}, - {file = "rpds_py-0.29.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:55d827b2ae95425d3be9bc9a5838b6c29d664924f98146557f7715e331d06df8"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:fc31a07ed352e5462d3ee1b22e89285f4ce97d5266f6d1169da1142e78045626"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:c4695dd224212f6105db7ea62197144230b808d6b2bba52238906a2762f1d1e7"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:fcae1770b401167f8b9e1e3f566562e6966ffa9ce63639916248a9e25fa8a244"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:90f30d15f45048448b8da21c41703b31c61119c06c216a1bf8c245812a0f0c17"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:44a91e0ab77bdc0004b43261a4b8cd6d6b451e8d443754cfda830002b5745b32"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:4aa195e5804d32c682e453b34474f411ca108e4291c6a0f824ebdc30a91c973c"}, - {file = "rpds_py-0.29.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:7971bdb7bf4ee0f7e6f67fa4c7fbc6019d9850cc977d126904392d363f6f8318"}, - {file = "rpds_py-0.29.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:8ae33ad9ce580c7a47452c3b3f7d8a9095ef6208e0a0c7e4e2384f9fc5bf8212"}, - {file = "rpds_py-0.29.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:c661132ab2fb4eeede2ef69670fd60da5235209874d001a98f1542f31f2a8a94"}, - {file = "rpds_py-0.29.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:bb78b3a0d31ac1bde132c67015a809948db751cb4e92cdb3f0b242e430b6ed0d"}, - {file = "rpds_py-0.29.0-cp314-cp314-win32.whl", hash = "sha256:f475f103488312e9bd4000bc890a95955a07b2d0b6e8884aef4be56132adbbf1"}, - {file = "rpds_py-0.29.0-cp314-cp314-win_amd64.whl", hash = "sha256:b9cf2359a4fca87cfb6801fae83a76aedf66ee1254a7a151f1341632acf67f1b"}, - {file = "rpds_py-0.29.0-cp314-cp314-win_arm64.whl", hash = "sha256:9ba8028597e824854f0f1733d8b964e914ae3003b22a10c2c664cb6927e0feb9"}, - {file = "rpds_py-0.29.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:e71136fd0612556b35c575dc2726ae04a1669e6a6c378f2240312cf5d1a2ab10"}, - {file = "rpds_py-0.29.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:76fe96632d53f3bf0ea31ede2f53bbe3540cc2736d4aec3b3801b0458499ef3a"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:9459a33f077130dbb2c7c3cea72ee9932271fb3126404ba2a2661e4fe9eb7b79"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5c9546cfdd5d45e562cc0444b6dddc191e625c62e866bf567a2c69487c7ad28a"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:12597d11d97b8f7e376c88929a6e17acb980e234547c92992f9f7c058f1a7310"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:28de03cf48b8a9e6ec10318f2197b83946ed91e2891f651a109611be4106ac4b"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:fd7951c964069039acc9d67a8ff1f0a7f34845ae180ca542b17dc1456b1f1808"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:c07d107b7316088f1ac0177a7661ca0c6670d443f6fe72e836069025e6266761"}, - {file = "rpds_py-0.29.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:1de2345af363d25696969befc0c1688a6cb5e8b1d32b515ef84fc245c6cddba3"}, - {file = "rpds_py-0.29.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:00e56b12d2199ca96068057e1ae7f9998ab6e99cda82431afafd32f3ec98cca9"}, - {file = "rpds_py-0.29.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3919a3bbecee589300ed25000b6944174e07cd20db70552159207b3f4bbb45b8"}, - {file = "rpds_py-0.29.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:e7fa2ccc312bbd91e43aa5e0869e46bc03278a3dddb8d58833150a18b0f0283a"}, - {file = "rpds_py-0.29.0-cp314-cp314t-win32.whl", hash = "sha256:97c817863ffc397f1e6a6e9d2d89fe5408c0a9922dac0329672fb0f35c867ea5"}, - {file = "rpds_py-0.29.0-cp314-cp314t-win_amd64.whl", hash = "sha256:2023473f444752f0f82a58dfcbee040d0a1b3d1b3c2ec40e884bd25db6d117d2"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:acd82a9e39082dc5f4492d15a6b6c8599aa21db5c35aaf7d6889aea16502c07d"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:715b67eac317bf1c7657508170a3e011a1ea6ccb1c9d5f296e20ba14196be6b3"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f3b1b87a237cb2dba4db18bcfaaa44ba4cd5936b91121b62292ff21df577fc43"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:1c3c3e8101bb06e337c88eb0c0ede3187131f19d97d43ea0e1c5407ea74c0cbf"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:2b8e54d6e61f3ecd3abe032065ce83ea63417a24f437e4a3d73d2f85ce7b7cfe"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:3fbd4e9aebf110473a420dea85a238b254cf8a15acb04b22a5a6b5ce8925b760"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:80fdf53d36e6c72819993e35d1ebeeb8e8fc688d0c6c2b391b55e335b3afba5a"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:ea7173df5d86f625f8dde6d5929629ad811ed8decda3b60ae603903839ac9ac0"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:76054d540061eda273274f3d13a21a4abdde90e13eaefdc205db37c05230efce"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:9f84c549746a5be3bc7415830747a3a0312573afc9f95785eb35228bb17742ec"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:0ea962671af5cb9a260489e311fa22b2e97103e3f9f0caaea6f81390af96a9ed"}, - {file = "rpds_py-0.29.0-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:f7728653900035fb7b8d06e1e5900545d8088efc9d5d4545782da7df03ec803f"}, - {file = "rpds_py-0.29.0.tar.gz", hash = "sha256:fe55fe686908f50154d1dc599232016e50c243b438c3b7432f24e2895b0e5359"}, + {file = "rpds_py-0.30.0-cp310-cp310-macosx_10_12_x86_64.whl", hash = "sha256:679ae98e00c0e8d68a7fda324e16b90fd5260945b45d3b824c892cec9eea3288"}, + {file = "rpds_py-0.30.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4cc2206b76b4f576934f0ed374b10d7ca5f457858b157ca52064bdfc26b9fc00"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:389a2d49eded1896c3d48b0136ead37c48e221b391c052fba3f4055c367f60a6"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:32c8528634e1bf7121f3de08fa85b138f4e0dc47657866630611b03967f041d7"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f207f69853edd6f6700b86efb84999651baf3789e78a466431df1331608e5324"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:67b02ec25ba7a9e8fa74c63b6ca44cf5707f2fbfadae3ee8e7494297d56aa9df"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0c0e95f6819a19965ff420f65578bacb0b00f251fefe2c8b23347c37174271f3"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_31_riscv64.whl", hash = "sha256:a452763cc5198f2f98898eb98f7569649fe5da666c2dc6b5ddb10fde5a574221"}, + {file = "rpds_py-0.30.0-cp310-cp310-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:e0b65193a413ccc930671c55153a03ee57cecb49e6227204b04fae512eb657a7"}, + {file = "rpds_py-0.30.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:858738e9c32147f78b3ac24dc0edb6610000e56dc0f700fd5f651d0a0f0eb9ff"}, + {file = "rpds_py-0.30.0-cp310-cp310-musllinux_1_2_i686.whl", hash = "sha256:da279aa314f00acbb803da1e76fa18666778e8a8f83484fba94526da5de2cba7"}, + {file = "rpds_py-0.30.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:7c64d38fb49b6cdeda16ab49e35fe0da2e1e9b34bc38bd78386530f218b37139"}, + {file = "rpds_py-0.30.0-cp310-cp310-win32.whl", hash = "sha256:6de2a32a1665b93233cde140ff8b3467bdb9e2af2b91079f0333a0974d12d464"}, + {file = "rpds_py-0.30.0-cp310-cp310-win_amd64.whl", hash = "sha256:1726859cd0de969f88dc8673bdd954185b9104e05806be64bcd87badbe313169"}, + {file = "rpds_py-0.30.0-cp311-cp311-macosx_10_12_x86_64.whl", hash = "sha256:a2bffea6a4ca9f01b3f8e548302470306689684e61602aa3d141e34da06cf425"}, + {file = "rpds_py-0.30.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:dc4f992dfe1e2bc3ebc7444f6c7051b4bc13cd8e33e43511e8ffd13bf407010d"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:422c3cb9856d80b09d30d2eb255d0754b23e090034e1deb4083f8004bd0761e4"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:07ae8a593e1c3c6b82ca3292efbe73c30b61332fd612e05abee07c79359f292f"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:12f90dd7557b6bd57f40abe7747e81e0c0b119bef015ea7726e69fe550e394a4"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:99b47d6ad9a6da00bec6aabe5a6279ecd3c06a329d4aa4771034a21e335c3a97"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:33f559f3104504506a44bb666b93a33f5d33133765b0c216a5bf2f1e1503af89"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_31_riscv64.whl", hash = "sha256:946fe926af6e44f3697abbc305ea168c2c31d3e3ef1058cf68f379bf0335a78d"}, + {file = "rpds_py-0.30.0-cp311-cp311-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:495aeca4b93d465efde585977365187149e75383ad2684f81519f504f5c13038"}, + {file = "rpds_py-0.30.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9a0ca5da0386dee0655b4ccdf46119df60e0f10da268d04fe7cc87886872ba7"}, + {file = "rpds_py-0.30.0-cp311-cp311-musllinux_1_2_i686.whl", hash = "sha256:8d6d1cc13664ec13c1b84241204ff3b12f9bb82464b8ad6e7a5d3486975c2eed"}, + {file = "rpds_py-0.30.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:3896fa1be39912cf0757753826bc8bdc8ca331a28a7c4ae46b7a21280b06bb85"}, + {file = "rpds_py-0.30.0-cp311-cp311-win32.whl", hash = "sha256:55f66022632205940f1827effeff17c4fa7ae1953d2b74a8581baaefb7d16f8c"}, + {file = "rpds_py-0.30.0-cp311-cp311-win_amd64.whl", hash = "sha256:a51033ff701fca756439d641c0ad09a41d9242fa69121c7d8769604a0a629825"}, + {file = "rpds_py-0.30.0-cp311-cp311-win_arm64.whl", hash = "sha256:47b0ef6231c58f506ef0b74d44e330405caa8428e770fec25329ed2cb971a229"}, + {file = "rpds_py-0.30.0-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:a161f20d9a43006833cd7068375a94d035714d73a172b681d8881820600abfad"}, + {file = "rpds_py-0.30.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6abc8880d9d036ecaafe709079969f56e876fcf107f7a8e9920ba6d5a3878d05"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:ca28829ae5f5d569bb62a79512c842a03a12576375d5ece7d2cadf8abe96ec28"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:a1010ed9524c73b94d15919ca4d41d8780980e1765babf85f9a2f90d247153dd"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:f8d1736cfb49381ba528cd5baa46f82fdc65c06e843dab24dd70b63d09121b3f"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:d948b135c4693daff7bc2dcfc4ec57237a29bd37e60c2fabf5aff2bbacf3e2f1"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47f236970bccb2233267d89173d3ad2703cd36a0e2a6e92d0560d333871a3d23"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_31_riscv64.whl", hash = "sha256:2e6ecb5a5bcacf59c3f912155044479af1d0b6681280048b338b28e364aca1f6"}, + {file = "rpds_py-0.30.0-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a8fa71a2e078c527c3e9dc9fc5a98c9db40bcc8a92b4e8858e36d329f8684b51"}, + {file = "rpds_py-0.30.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:73c67f2db7bc334e518d097c6d1e6fed021bbc9b7d678d6cc433478365d1d5f5"}, + {file = "rpds_py-0.30.0-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:5ba103fb455be00f3b1c2076c9d4264bfcb037c976167a6047ed82f23153f02e"}, + {file = "rpds_py-0.30.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7cee9c752c0364588353e627da8a7e808a66873672bcb5f52890c33fd965b394"}, + {file = "rpds_py-0.30.0-cp312-cp312-win32.whl", hash = "sha256:1ab5b83dbcf55acc8b08fc62b796ef672c457b17dbd7820a11d6c52c06839bdf"}, + {file = "rpds_py-0.30.0-cp312-cp312-win_amd64.whl", hash = "sha256:a090322ca841abd453d43456ac34db46e8b05fd9b3b4ac0c78bcde8b089f959b"}, + {file = "rpds_py-0.30.0-cp312-cp312-win_arm64.whl", hash = "sha256:669b1805bd639dd2989b281be2cfd951c6121b65e729d9b843e9639ef1fd555e"}, + {file = "rpds_py-0.30.0-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:f83424d738204d9770830d35290ff3273fbb02b41f919870479fab14b9d303b2"}, + {file = "rpds_py-0.30.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e7536cd91353c5273434b4e003cbda89034d67e7710eab8761fd918ec6c69cf8"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:2771c6c15973347f50fece41fc447c054b7ac2ae0502388ce3b6738cd366e3d4"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:0a59119fc6e3f460315fe9d08149f8102aa322299deaa5cab5b40092345c2136"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:76fec018282b4ead0364022e3c54b60bf368b9d926877957a8624b58419169b7"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:692bef75a5525db97318e8cd061542b5a79812d711ea03dbc1f6f8dbb0c5f0d2"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9027da1ce107104c50c81383cae773ef5c24d296dd11c99e2629dbd7967a20c6"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_31_riscv64.whl", hash = "sha256:9cf69cdda1f5968a30a359aba2f7f9aa648a9ce4b580d6826437f2b291cfc86e"}, + {file = "rpds_py-0.30.0-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:a4796a717bf12b9da9d3ad002519a86063dcac8988b030e405704ef7d74d2d9d"}, + {file = "rpds_py-0.30.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5d4c2aa7c50ad4728a094ebd5eb46c452e9cb7edbfdb18f9e1221f597a73e1e7"}, + {file = "rpds_py-0.30.0-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:ba81a9203d07805435eb06f536d95a266c21e5b2dfbf6517748ca40c98d19e31"}, + {file = "rpds_py-0.30.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:945dccface01af02675628334f7cf49c2af4c1c904748efc5cf7bbdf0b579f95"}, + {file = "rpds_py-0.30.0-cp313-cp313-win32.whl", hash = "sha256:b40fb160a2db369a194cb27943582b38f79fc4887291417685f3ad693c5a1d5d"}, + {file = "rpds_py-0.30.0-cp313-cp313-win_amd64.whl", hash = "sha256:806f36b1b605e2d6a72716f321f20036b9489d29c51c91f4dd29a3e3afb73b15"}, + {file = "rpds_py-0.30.0-cp313-cp313-win_arm64.whl", hash = "sha256:d96c2086587c7c30d44f31f42eae4eac89b60dabbac18c7669be3700f13c3ce1"}, + {file = "rpds_py-0.30.0-cp313-cp313t-macosx_10_12_x86_64.whl", hash = "sha256:eb0b93f2e5c2189ee831ee43f156ed34e2a89a78a66b98cadad955972548be5a"}, + {file = "rpds_py-0.30.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:922e10f31f303c7c920da8981051ff6d8c1a56207dbdf330d9047f6d30b70e5e"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cdc62c8286ba9bf7f47befdcea13ea0e26bf294bda99758fd90535cbaf408000"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:47f9a91efc418b54fb8190a6b4aa7813a23fb79c51f4bb84e418f5476c38b8db"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:1f3587eb9b17f3789ad50824084fa6f81921bbf9a795826570bda82cb3ed91f2"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:39c02563fc592411c2c61d26b6c5fe1e51eaa44a75aa2c8735ca88b0d9599daa"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:51a1234d8febafdfd33a42d97da7a43f5dcb120c1060e352a3fbc0c6d36e2083"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_31_riscv64.whl", hash = "sha256:eb2c4071ab598733724c08221091e8d80e89064cd472819285a9ab0f24bcedb9"}, + {file = "rpds_py-0.30.0-cp313-cp313t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:6bdfdb946967d816e6adf9a3d8201bfad269c67efe6cefd7093ef959683c8de0"}, + {file = "rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:c77afbd5f5250bf27bf516c7c4a016813eb2d3e116139aed0096940c5982da94"}, + {file = "rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:61046904275472a76c8c90c9ccee9013d70a6d0f73eecefd38c1ae7c39045a08"}, + {file = "rpds_py-0.30.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:4c5f36a861bc4b7da6516dbdf302c55313afa09b81931e8280361a4f6c9a2d27"}, + {file = "rpds_py-0.30.0-cp313-cp313t-win32.whl", hash = "sha256:3d4a69de7a3e50ffc214ae16d79d8fbb0922972da0356dcf4d0fdca2878559c6"}, + {file = "rpds_py-0.30.0-cp313-cp313t-win_amd64.whl", hash = "sha256:f14fc5df50a716f7ece6a80b6c78bb35ea2ca47c499e422aa4463455dd96d56d"}, + {file = "rpds_py-0.30.0-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:68f19c879420aa08f61203801423f6cd5ac5f0ac4ac82a2368a9fcd6a9a075e0"}, + {file = "rpds_py-0.30.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:ec7c4490c672c1a0389d319b3a9cfcd098dcdc4783991553c332a15acf7249be"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f251c812357a3fed308d684a5079ddfb9d933860fc6de89f2b7ab00da481e65f"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ac98b175585ecf4c0348fd7b29c3864bda53b805c773cbf7bfdaffc8070c976f"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3e62880792319dbeb7eb866547f2e35973289e7d5696c6e295476448f5b63c87"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:4e7fc54e0900ab35d041b0601431b0a0eb495f0851a0639b6ef90f7741b39a18"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:47e77dc9822d3ad616c3d5759ea5631a75e5809d5a28707744ef79d7a1bcfcad"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_31_riscv64.whl", hash = "sha256:b4dc1a6ff022ff85ecafef7979a2c6eb423430e05f1165d6688234e62ba99a07"}, + {file = "rpds_py-0.30.0-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:4559c972db3a360808309e06a74628b95eaccbf961c335c8fe0d590cf587456f"}, + {file = "rpds_py-0.30.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:0ed177ed9bded28f8deb6ab40c183cd1192aa0de40c12f38be4d59cd33cb5c65"}, + {file = "rpds_py-0.30.0-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:ad1fa8db769b76ea911cb4e10f049d80bf518c104f15b3edb2371cc65375c46f"}, + {file = "rpds_py-0.30.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:46e83c697b1f1c72b50e5ee5adb4353eef7406fb3f2043d64c33f20ad1c2fc53"}, + {file = "rpds_py-0.30.0-cp314-cp314-win32.whl", hash = "sha256:ee454b2a007d57363c2dfd5b6ca4a5d7e2c518938f8ed3b706e37e5d470801ed"}, + {file = "rpds_py-0.30.0-cp314-cp314-win_amd64.whl", hash = "sha256:95f0802447ac2d10bcc69f6dc28fe95fdf17940367b21d34e34c737870758950"}, + {file = "rpds_py-0.30.0-cp314-cp314-win_arm64.whl", hash = "sha256:613aa4771c99f03346e54c3f038e4cc574ac09a3ddfb0e8878487335e96dead6"}, + {file = "rpds_py-0.30.0-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:7e6ecfcb62edfd632e56983964e6884851786443739dbfe3582947e87274f7cb"}, + {file = "rpds_py-0.30.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:a1d0bc22a7cdc173fedebb73ef81e07faef93692b8c1ad3733b67e31e1b6e1b8"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0d08f00679177226c4cb8c5265012eea897c8ca3b93f429e546600c971bcbae7"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:5965af57d5848192c13534f90f9dd16464f3c37aaf166cc1da1cae1fd5a34898"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9a4e86e34e9ab6b667c27f3211ca48f73dba7cd3d90f8d5b11be56e5dbc3fb4e"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e5d3e6b26f2c785d65cc25ef1e5267ccbe1b069c5c21b8cc724efee290554419"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:626a7433c34566535b6e56a1b39a7b17ba961e97ce3b80ec62e6f1312c025551"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_31_riscv64.whl", hash = "sha256:acd7eb3f4471577b9b5a41baf02a978e8bdeb08b4b355273994f8b87032000a8"}, + {file = "rpds_py-0.30.0-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:fe5fa731a1fa8a0a56b0977413f8cacac1768dad38d16b3a296712709476fbd5"}, + {file = "rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:74a3243a411126362712ee1524dfc90c650a503502f135d54d1b352bd01f2404"}, + {file = "rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:3e8eeb0544f2eb0d2581774be4c3410356eba189529a6b3e36bbbf9696175856"}, + {file = "rpds_py-0.30.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:dbd936cde57abfee19ab3213cf9c26be06d60750e60a8e4dd85d1ab12c8b1f40"}, + {file = "rpds_py-0.30.0-cp314-cp314t-win32.whl", hash = "sha256:dc824125c72246d924f7f796b4f63c1e9dc810c7d9e2355864b3c3a73d59ade0"}, + {file = "rpds_py-0.30.0-cp314-cp314t-win_amd64.whl", hash = "sha256:27f4b0e92de5bfbc6f86e43959e6edd1425c33b5e69aab0984a72047f2bcf1e3"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-macosx_10_12_x86_64.whl", hash = "sha256:c2262bdba0ad4fc6fb5545660673925c2d2a5d9e2e0fb603aad545427be0fc58"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:ee6af14263f25eedc3bb918a3c04245106a42dfd4f5c2285ea6f997b1fc3f89a"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3adbb8179ce342d235c31ab8ec511e66c73faa27a47e076ccc92421add53e2bb"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:250fa00e9543ac9b97ac258bd37367ff5256666122c2d0f2bc97577c60a1818c"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:9854cf4f488b3d57b9aaeb105f06d78e5529d3145b1e4a41750167e8c213c6d3"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:993914b8e560023bc0a8bf742c5f303551992dcb85e247b1e5c7f4a7d145bda5"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:58edca431fb9b29950807e301826586e5bbf24163677732429770a697ffe6738"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_31_riscv64.whl", hash = "sha256:dea5b552272a944763b34394d04577cf0f9bd013207bc32323b5a89a53cf9c2f"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:ba3af48635eb83d03f6c9735dfb21785303e73d22ad03d489e88adae6eab8877"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_aarch64.whl", hash = "sha256:dff13836529b921e22f15cb099751209a60009731a68519630a24d61f0b1b30a"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_i686.whl", hash = "sha256:1b151685b23929ab7beec71080a8889d4d6d9fa9a983d213f07121205d48e2c4"}, + {file = "rpds_py-0.30.0-pp311-pypy311_pp73-musllinux_1_2_x86_64.whl", hash = "sha256:ac37f9f516c51e5753f27dfdef11a88330f04de2d564be3991384b2f3535d02e"}, + {file = "rpds_py-0.30.0.tar.gz", hash = "sha256:dd8ff7cf90014af0c0f787eea34794ebf6415242ee1d6fa91eaba725cc441e84"}, ] [[package]] From 4e490a7e85ff9766b2364731149ffa8a759069d1 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 17 Dec 2025 00:04:19 +0000 Subject: [PATCH 10/55] pip(deps): bump urllib3 from 2.5.0 to 2.6.0 Bumps [urllib3](https://github.com/urllib3/urllib3) from 2.5.0 to 2.6.0. - [Release notes](https://github.com/urllib3/urllib3/releases) - [Changelog](https://github.com/urllib3/urllib3/blob/main/CHANGES.rst) - [Commits](https://github.com/urllib3/urllib3/compare/2.5.0...2.6.0) --- updated-dependencies: - dependency-name: urllib3 dependency-version: 2.6.0 dependency-type: indirect update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- poetry.lock | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/poetry.lock b/poetry.lock index 6f54b615f..cf32f8f33 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1988,21 +1988,21 @@ typing-extensions = ">=4.12.0" [[package]] name = "urllib3" -version = "2.5.0" +version = "2.6.2" description = "HTTP library with thread-safe connection pooling, file post, and more." optional = false python-versions = ">=3.9" groups = ["main", "dev"] files = [ - {file = "urllib3-2.5.0-py3-none-any.whl", hash = "sha256:e6b01673c0fa6a13e374b50871808eb3bf7046c4b125b216f6bf1cc604cff0dc"}, - {file = "urllib3-2.5.0.tar.gz", hash = "sha256:3fc47733c7e419d4bc3f6b3dc2b4f890bb743906a30d56ba4a5bfa4bbff92760"}, + {file = "urllib3-2.6.2-py3-none-any.whl", hash = "sha256:ec21cddfe7724fc7cb4ba4bea7aa8e2ef36f607a4bab81aa6ce42a13dc3f03dd"}, + {file = "urllib3-2.6.2.tar.gz", hash = "sha256:016f9c98bb7e98085cb2b4b17b87d2c702975664e4f060c6532e64d1c1a5e797"}, ] [package.extras] -brotli = ["brotli (>=1.0.9) ; platform_python_implementation == \"CPython\"", "brotlicffi (>=0.8.0) ; platform_python_implementation != \"CPython\""] +brotli = ["brotli (>=1.2.0) ; platform_python_implementation == \"CPython\"", "brotlicffi (>=1.2.0.0) ; platform_python_implementation != \"CPython\""] h2 = ["h2 (>=4,<5)"] socks = ["pysocks (>=1.5.6,!=1.5.7,<2.0)"] -zstd = ["zstandard (>=0.18.0)"] +zstd = ["backports-zstd (>=1.0.0) ; python_version < \"3.14\""] [[package]] name = "wcwidth" From 245c0ecf2c0372f6b017309de5e236e1f8e22231 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 15 Jan 2026 00:23:46 +0000 Subject: [PATCH 11/55] Bump undici from 6.22.0 to 6.23.0 Bumps [undici](https://github.com/nodejs/undici) from 6.22.0 to 6.23.0. - [Release notes](https://github.com/nodejs/undici/releases) - [Commits](https://github.com/nodejs/undici/compare/v6.22.0...v6.23.0) --- updated-dependencies: - dependency-name: undici dependency-version: 6.23.0 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 15fbe7044..86653d771 100644 --- a/package-lock.json +++ b/package-lock.json @@ -3212,9 +3212,9 @@ } }, "node_modules/undici": { - "version": "6.22.0", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.22.0.tgz", - "integrity": "sha512-hU/10obOIu62MGYjdskASR3CUAiYaFTtC9Pa6vHyf//mAipSvSQg6od2CnJswq7fvzNS3zJhxoRkgNVaHurWKw==", + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.23.0.tgz", + "integrity": "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g==", "engines": { "node": ">=18.17" } @@ -5664,9 +5664,9 @@ "optional": true }, "undici": { - "version": "6.22.0", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.22.0.tgz", - "integrity": "sha512-hU/10obOIu62MGYjdskASR3CUAiYaFTtC9Pa6vHyf//mAipSvSQg6od2CnJswq7fvzNS3zJhxoRkgNVaHurWKw==" + "version": "6.23.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.23.0.tgz", + "integrity": "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g==" }, "undici-types": { "version": "7.16.0", From 909e98a174bd001d8fa3efccb6acc68b0b257d9a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 16 Jan 2026 00:04:19 +0000 Subject: [PATCH 12/55] sandbox-npm(deps-dev): bump @eslint-community/eslint-utils in /sandbox Bumps [@eslint-community/eslint-utils](https://github.com/eslint-community/eslint-utils) from 4.9.0 to 4.9.1. - [Release notes](https://github.com/eslint-community/eslint-utils/releases) - [Commits](https://github.com/eslint-community/eslint-utils/compare/v4.9.0...v4.9.1) --- updated-dependencies: - dependency-name: "@eslint-community/eslint-utils" dependency-version: 4.9.1 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index f8d535bbd..bb9bff2b4 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -19,9 +19,9 @@ } }, "node_modules/@eslint-community/eslint-utils": { - "version": "4.9.0", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", - "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "version": "4.9.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", "dev": true, "dependencies": { "eslint-visitor-keys": "^3.4.3" @@ -1378,9 +1378,9 @@ }, "dependencies": { "@eslint-community/eslint-utils": { - "version": "4.9.0", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", - "integrity": "sha512-ayVFHdtZ+hsq1t2Dy24wCmGXGe4q9Gu3smhLYALJrr473ZH27MsnSL+LKUlimp4BWJqMDMLmPpx/Q9R3OAlL4g==", + "version": "4.9.1", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", + "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", "dev": true, "requires": { "eslint-visitor-keys": "^3.4.3" From f12a8d8a7033163708d581bd421c4a93a6207790 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 16 Jan 2026 00:04:19 +0000 Subject: [PATCH 13/55] sandbox-npm(deps-dev): bump esquery from 1.6.0 to 1.7.0 in /sandbox Bumps [esquery](https://github.com/estools/esquery) from 1.6.0 to 1.7.0. - [Commits](https://github.com/estools/esquery/commits) --- updated-dependencies: - dependency-name: esquery dependency-version: 1.7.0 dependency-type: indirect update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index f8d535bbd..68d33a55e 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -860,9 +860,9 @@ } }, "node_modules/esquery": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", - "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", "dev": true, "dependencies": { "estraverse": "^5.1.0" @@ -2029,9 +2029,9 @@ } }, "esquery": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", - "integrity": "sha512-ca9pw9fomFcKPvFLXhBKUK90ZvGibiGOvRJNbjljY7s7uq/5YO4BOzcYtJqExdx99rF6aAcnRxHmcUHcz6sQsg==", + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", + "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", "dev": true, "requires": { "estraverse": "^5.1.0" From 32d3293dfef01849306803c974882ed914963eaa Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 16 Jan 2026 00:04:24 +0000 Subject: [PATCH 14/55] sandbox-npm(deps-dev): bump globals from 16.5.0 to 17.0.0 in /sandbox Bumps [globals](https://github.com/sindresorhus/globals) from 16.5.0 to 17.0.0. - [Release notes](https://github.com/sindresorhus/globals/releases) - [Commits](https://github.com/sindresorhus/globals/compare/v16.5.0...v17.0.0) --- updated-dependencies: - dependency-name: globals dependency-version: 17.0.0 dependency-type: direct:development update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 14 +++++++------- sandbox/package.json | 2 +- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index f8d535bbd..78f9c1d13 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -15,7 +15,7 @@ }, "devDependencies": { "eslint": "^9.25.1", - "globals": "^16.5.0" + "globals": "^17.0.0" } }, "node_modules/@eslint-community/eslint-utils": { @@ -986,9 +986,9 @@ } }, "node_modules/globals": { - "version": "16.5.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz", - "integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==", + "version": "17.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz", + "integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==", "dev": true, "engines": { "node": ">=18" @@ -2121,9 +2121,9 @@ } }, "globals": { - "version": "16.5.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz", - "integrity": "sha512-c/c15i26VrJ4IRt5Z89DnIzCGDn9EcebibhAOjw5ibqEHsE1wLUgkPn9RDmNcUKyU87GeaL633nyJ+pplFR2ZQ==", + "version": "17.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz", + "integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==", "dev": true }, "ignore": { diff --git a/sandbox/package.json b/sandbox/package.json index 92b383c9b..9a3dbb821 100644 --- a/sandbox/package.json +++ b/sandbox/package.json @@ -18,6 +18,6 @@ }, "devDependencies": { "eslint": "^9.25.1", - "globals": "^16.5.0" + "globals": "^17.0.0" } } From e7ce8d386e9311307b2a6b772ae2555542b16c95 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Sat, 28 Feb 2026 09:21:54 +0000 Subject: [PATCH 15/55] Bump minimatch from 3.1.2 to 3.1.5 in /sandbox Bumps [minimatch](https://github.com/isaacs/minimatch) from 3.1.2 to 3.1.5. - [Changelog](https://github.com/isaacs/minimatch/blob/main/changelog.md) - [Commits](https://github.com/isaacs/minimatch/compare/v3.1.2...v3.1.5) --- updated-dependencies: - dependency-name: minimatch dependency-version: 3.1.5 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index 1df91973f..efdee1069 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -1151,11 +1151,10 @@ } }, "node_modules/minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", "dev": true, - "license": "ISC", "dependencies": { "brace-expansion": "^1.1.7" }, @@ -2241,9 +2240,9 @@ "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==" }, "minimatch": { - "version": "3.1.2", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.2.tgz", - "integrity": "sha512-J7p63hRiAjw1NDEww1W7i37+ByIrOWO5XQQAzZ3VOcL0PNybwpfmV/N05zFAzwQ9USyEcX6t3UO+K5aqBQOIHw==", + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", "dev": true, "requires": { "brace-expansion": "^1.1.7" From 48d91532034cfef52c55835ad13bf7d2ecd111ab Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 4 Mar 2026 00:04:45 +0000 Subject: [PATCH 16/55] npm(deps-dev): bump spdx-license-ids from 3.0.22 to 3.0.23 Bumps [spdx-license-ids](https://github.com/jslicense/spdx-license-ids) from 3.0.22 to 3.0.23. - [Commits](https://github.com/jslicense/spdx-license-ids/compare/v3.0.22...v3.0.23) --- updated-dependencies: - dependency-name: spdx-license-ids dependency-version: 3.0.23 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 4090cf964..c0f5a8279 100644 --- a/package-lock.json +++ b/package-lock.json @@ -3002,9 +3002,9 @@ } }, "node_modules/spdx-license-ids": { - "version": "3.0.22", - "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.22.tgz", - "integrity": "sha512-4PRT4nh1EImPbt2jASOKHX7PB7I+e4IWNLvkKFDxNhJlfjbYlleYQh285Z/3mPTHSAK/AvdMmw5BNNuYH8ShgQ==", + "version": "3.0.23", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.23.tgz", + "integrity": "sha512-CWLcCCH7VLu13TgOH+r8p1O/Znwhqv/dbb6lqWy67G+pT1kHmeD/+V36AVb/vq8QMIQwVShJ6Ssl5FPh0fuSdw==", "dev": true }, "node_modules/spdx-ranges": { @@ -5513,9 +5513,9 @@ } }, "spdx-license-ids": { - "version": "3.0.22", - "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.22.tgz", - "integrity": "sha512-4PRT4nh1EImPbt2jASOKHX7PB7I+e4IWNLvkKFDxNhJlfjbYlleYQh285Z/3mPTHSAK/AvdMmw5BNNuYH8ShgQ==", + "version": "3.0.23", + "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.23.tgz", + "integrity": "sha512-CWLcCCH7VLu13TgOH+r8p1O/Znwhqv/dbb6lqWy67G+pT1kHmeD/+V36AVb/vq8QMIQwVShJ6Ssl5FPh0fuSdw==", "dev": true }, "spdx-ranges": { From f25ef4f7954a4b7b4362e3117883726506cc56a3 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 4 Mar 2026 00:05:03 +0000 Subject: [PATCH 17/55] npm(deps): bump core-js from 3.46.0 to 3.48.0 Bumps [core-js](https://github.com/zloirock/core-js/tree/HEAD/packages/core-js) from 3.46.0 to 3.48.0. - [Release notes](https://github.com/zloirock/core-js/releases) - [Changelog](https://github.com/zloirock/core-js/blob/master/CHANGELOG.md) - [Commits](https://github.com/zloirock/core-js/commits/v3.48.0/packages/core-js) --- updated-dependencies: - dependency-name: core-js dependency-version: 3.48.0 dependency-type: indirect update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 4090cf964..620836c75 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1045,9 +1045,9 @@ } }, "node_modules/core-js": { - "version": "3.46.0", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.46.0.tgz", - "integrity": "sha512-vDMm9B0xnqqZ8uSBpZ8sNtRtOdmfShrvT6h2TuQGLs0Is+cR0DYbj/KWP6ALVNbWPpqA/qPLoOuppJN07humpA==", + "version": "3.48.0", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.48.0.tgz", + "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==", "hasInstallScript": true, "funding": { "type": "opencollective", @@ -4171,9 +4171,9 @@ "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==" }, "core-js": { - "version": "3.46.0", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.46.0.tgz", - "integrity": "sha512-vDMm9B0xnqqZ8uSBpZ8sNtRtOdmfShrvT6h2TuQGLs0Is+cR0DYbj/KWP6ALVNbWPpqA/qPLoOuppJN07humpA==" + "version": "3.48.0", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.48.0.tgz", + "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==" }, "css-color-keywords": { "version": "1.0.0", From 0b24be8625349ed4fceb73645c3e539354c81779 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 4 Mar 2026 00:05:41 +0000 Subject: [PATCH 18/55] npm(deps): bump react from 19.2.0 to 19.2.4 Bumps [react](https://github.com/facebook/react/tree/HEAD/packages/react) from 19.2.0 to 19.2.4. - [Release notes](https://github.com/facebook/react/releases) - [Changelog](https://github.com/facebook/react/blob/main/CHANGELOG.md) - [Commits](https://github.com/facebook/react/commits/v19.2.4/packages/react) --- updated-dependencies: - dependency-name: react dependency-version: 19.2.4 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 4090cf964..c2dd7336a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -2605,9 +2605,9 @@ } }, "node_modules/react": { - "version": "19.2.0", - "resolved": "https://registry.npmjs.org/react/-/react-19.2.0.tgz", - "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==", + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", + "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==", "engines": { "node": ">=0.10.0" } @@ -5224,9 +5224,9 @@ } }, "react": { - "version": "19.2.0", - "resolved": "https://registry.npmjs.org/react/-/react-19.2.0.tgz", - "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==" + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", + "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==" }, "react-dom": { "version": "19.2.0", From 4f8c97b1cec55b69c0a3a2433d4bf243e77fd857 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 4 Mar 2026 22:06:22 +0000 Subject: [PATCH 19/55] Bump authlib from 1.6.6 to 1.6.7 Bumps [authlib](https://github.com/authlib/authlib) from 1.6.6 to 1.6.7. - [Release notes](https://github.com/authlib/authlib/releases) - [Changelog](https://github.com/authlib/authlib/blob/main/docs/changelog.rst) - [Commits](https://github.com/authlib/authlib/compare/v1.6.6...v1.6.7) --- updated-dependencies: - dependency-name: authlib dependency-version: 1.6.7 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- poetry.lock | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/poetry.lock b/poetry.lock index 6ede82e20..7a053c812 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand. +# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand. [[package]] name = "annotated-types" @@ -26,14 +26,14 @@ files = [ [[package]] name = "authlib" -version = "1.6.6" +version = "1.6.7" description = "The ultimate Python library in building OAuth and OpenID Connect servers and clients." optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "authlib-1.6.6-py2.py3-none-any.whl", hash = "sha256:7d9e9bc535c13974313a87f53e8430eb6ea3d1cf6ae4f6efcd793f2e949143fd"}, - {file = "authlib-1.6.6.tar.gz", hash = "sha256:45770e8e056d0f283451d9996fbb59b70d45722b45d854d58f32878d0a40c38e"}, + {file = "authlib-1.6.7-py2.py3-none-any.whl", hash = "sha256:c637340d9a02789d2efa1d003a7437d10d3e565237bcb5fcbc6c134c7b95bab0"}, + {file = "authlib-1.6.7.tar.gz", hash = "sha256:dbf10100011d1e1b34048c9d120e83f13b35d69a826ae762b93d2fb5aafc337b"}, ] [package.dependencies] @@ -584,7 +584,7 @@ files = [ [package.dependencies] attrs = ">=22.2.0" -jsonschema-specifications = ">=2023.3.6" +jsonschema-specifications = ">=2023.03.6" referencing = ">=0.28.4" rpds-py = ">=0.7.1" From d2a02ae6c0da75431de299222bfdc016a0dc1d5a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 6 Mar 2026 00:04:41 +0000 Subject: [PATCH 20/55] npm(deps): bump default-browser from 5.3.0 to 5.5.0 Bumps [default-browser](https://github.com/sindresorhus/default-browser) from 5.3.0 to 5.5.0. - [Release notes](https://github.com/sindresorhus/default-browser/releases) - [Commits](https://github.com/sindresorhus/default-browser/compare/v5.3.0...v5.5.0) --- updated-dependencies: - dependency-name: default-browser dependency-version: 5.5.0 dependency-type: indirect update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9b55d0b6b..57b7f08be 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1111,9 +1111,9 @@ "integrity": "sha512-m8FnyHXV1QX+S1cl+KPFDIl6NMkxtKsy6+U/aYyjrOqWMuwAwYWu7ePqrsUHtDR5Y8Yk2pi/KIDSgF+vT4cPOQ==" }, "node_modules/default-browser": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.3.0.tgz", - "integrity": "sha512-Qq68+VkJlc8tjnPV1i7HtbIn7ohmjZa88qUvHMIK0ZKUXMCuV45cT7cEXALPUmeXCe0q1DWQkQTemHVaLIFSrg==", + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz", + "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==", "dependencies": { "bundle-name": "^4.1.0", "default-browser-id": "^5.0.0" @@ -4215,9 +4215,9 @@ "integrity": "sha512-m8FnyHXV1QX+S1cl+KPFDIl6NMkxtKsy6+U/aYyjrOqWMuwAwYWu7ePqrsUHtDR5Y8Yk2pi/KIDSgF+vT4cPOQ==" }, "default-browser": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.3.0.tgz", - "integrity": "sha512-Qq68+VkJlc8tjnPV1i7HtbIn7ohmjZa88qUvHMIK0ZKUXMCuV45cT7cEXALPUmeXCe0q1DWQkQTemHVaLIFSrg==", + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz", + "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==", "requires": { "bundle-name": "^4.1.0", "default-browser-id": "^5.0.0" From f33e71c428e0a66a7d200148d20ce1c66be14b45 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 6 Mar 2026 00:04:58 +0000 Subject: [PATCH 21/55] npm(deps): bump react-dom from 19.2.0 to 19.2.4 Bumps [react-dom](https://github.com/facebook/react/tree/HEAD/packages/react-dom) from 19.2.0 to 19.2.4. - [Release notes](https://github.com/facebook/react/releases) - [Changelog](https://github.com/facebook/react/blob/main/CHANGELOG.md) - [Commits](https://github.com/facebook/react/commits/v19.2.4/packages/react-dom) --- updated-dependencies: - dependency-name: react-dom dependency-version: 19.2.4 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9b55d0b6b..d395d859a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -2605,22 +2605,22 @@ } }, "node_modules/react": { - "version": "19.2.0", - "resolved": "https://registry.npmjs.org/react/-/react-19.2.0.tgz", - "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==", + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", + "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==", "engines": { "node": ">=0.10.0" } }, "node_modules/react-dom": { - "version": "19.2.0", - "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.0.tgz", - "integrity": "sha512-UlbRu4cAiGaIewkPyiRGJk0imDN2T3JjieT6spoL2UeSf5od4n5LB/mQ4ejmxhCFT1tYe8IvaFulzynWovsEFQ==", + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", + "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { - "react": "^19.2.0" + "react": "^19.2.4" } }, "node_modules/react-is": { @@ -5224,14 +5224,14 @@ } }, "react": { - "version": "19.2.0", - "resolved": "https://registry.npmjs.org/react/-/react-19.2.0.tgz", - "integrity": "sha512-tmbWg6W31tQLeB5cdIBOicJDJRR2KzXsV7uSK9iNfLWQ5bIZfxuPEHp7M8wiHyHnn0DD1i7w3Zmin0FtkrwoCQ==" + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", + "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==" }, "react-dom": { - "version": "19.2.0", - "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.0.tgz", - "integrity": "sha512-UlbRu4cAiGaIewkPyiRGJk0imDN2T3JjieT6spoL2UeSf5od4n5LB/mQ4ejmxhCFT1tYe8IvaFulzynWovsEFQ==", + "version": "19.2.4", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", + "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", "requires": { "scheduler": "^0.27.0" } From 152216a3b225507913c7c50cca82115a42b43a1b Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 9 Mar 2026 10:36:39 +0000 Subject: [PATCH 22/55] Bump dompurify from 3.3.0 to 3.3.2 Bumps [dompurify](https://github.com/cure53/DOMPurify) from 3.3.0 to 3.3.2. - [Release notes](https://github.com/cure53/DOMPurify/releases) - [Commits](https://github.com/cure53/DOMPurify/compare/3.3.0...3.3.2) --- updated-dependencies: - dependency-name: dompurify dependency-version: 3.3.2 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- package-lock.json | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index 9b55d0b6b..d600dfb7a 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1174,9 +1174,12 @@ } }, "node_modules/dompurify": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.0.tgz", - "integrity": "sha512-r+f6MYR1gGN1eJv0TVQbhA7if/U7P87cdPl3HN5rikqaBSBxLiCb/b9O+2eG0cxz0ghyU+mU1QkbsOwERMYlWQ==", + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.2.tgz", + "integrity": "sha512-6obghkliLdmKa56xdbLOpUZ43pAR6xFy1uOrxBaIDjT+yaRuuybLjGS9eVBoSR/UPU5fq3OXClEHLJNGvbxKpQ==", + "engines": { + "node": ">=20" + }, "optionalDependencies": { "@types/trusted-types": "^2.0.7" } @@ -4254,9 +4257,9 @@ "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==" }, "dompurify": { - "version": "3.3.0", - "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.0.tgz", - "integrity": "sha512-r+f6MYR1gGN1eJv0TVQbhA7if/U7P87cdPl3HN5rikqaBSBxLiCb/b9O+2eG0cxz0ghyU+mU1QkbsOwERMYlWQ==", + "version": "3.3.2", + "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.2.tgz", + "integrity": "sha512-6obghkliLdmKa56xdbLOpUZ43pAR6xFy1uOrxBaIDjT+yaRuuybLjGS9eVBoSR/UPU5fq3OXClEHLJNGvbxKpQ==", "requires": { "@types/trusted-types": "^2.0.7" } From 68b53b4519e1265ce6838697674c7882d080dd98 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 00:04:37 +0000 Subject: [PATCH 23/55] npm(deps): bump is-wsl from 3.1.0 to 3.1.1 Bumps [is-wsl](https://github.com/sindresorhus/is-wsl) from 3.1.0 to 3.1.1. - [Release notes](https://github.com/sindresorhus/is-wsl/releases) - [Commits](https://github.com/sindresorhus/is-wsl/compare/v3.1.0...v3.1.1) --- updated-dependencies: - dependency-name: is-wsl dependency-version: 3.1.1 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index fafd4a13d..234df3e9d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1701,9 +1701,9 @@ } }, "node_modules/is-wsl": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.0.tgz", - "integrity": "sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==", + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz", + "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==", "dependencies": { "is-inside-container": "^1.0.0" }, @@ -4607,9 +4607,9 @@ "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==" }, "is-wsl": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.0.tgz", - "integrity": "sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw==", + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz", + "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==", "requires": { "is-inside-container": "^1.0.0" } From e2a99383162fa04b7f01e84bdf1aa8b19288a94a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 00:04:51 +0000 Subject: [PATCH 24/55] npm(deps): bump fast-xml-parser from 5.3.7 to 5.5.1 Bumps [fast-xml-parser](https://github.com/NaturalIntelligence/fast-xml-parser) from 5.3.7 to 5.5.1. - [Release notes](https://github.com/NaturalIntelligence/fast-xml-parser/releases) - [Changelog](https://github.com/NaturalIntelligence/fast-xml-parser/blob/master/CHANGELOG.md) - [Commits](https://github.com/NaturalIntelligence/fast-xml-parser/compare/v5.3.7...v5.5.1) --- updated-dependencies: - dependency-name: fast-xml-parser dependency-version: 5.5.1 dependency-type: indirect update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] --- package-lock.json | 57 ++++++++++++++++++++++++++++++++++++++++++----- 1 file changed, 51 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index fafd4a13d..547ad1f79 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1321,10 +1321,24 @@ ], "peer": true }, + "node_modules/fast-xml-builder": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.0.tgz", + "integrity": "sha512-7mtITW/we2/wTUZqMyBOR2F8xP4CRxMiSEcQxPIqdRWdO2L/HZSOlzoNyghmyDwNB8BDxePooV1ZTJpkOUhdRg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "dependencies": { + "path-expression-matcher": "^1.1.2" + } + }, "node_modules/fast-xml-parser": { - "version": "5.3.7", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.3.7.tgz", - "integrity": "sha512-JzVLro9NQv92pOM/jTCR6mHlJh2FGwtomH8ZQjhFj/R29P2Fnj38OgPJVtcvYw6SuKClhgYuwUZf5b3rd8u2mA==", + "version": "5.5.1", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.1.tgz", + "integrity": "sha512-JTpMz8P5mDoNYzXTmTT/xzWjFiCWi0U+UQTJtrFH9muXsr2RqtXZPbnCW5h2mKsOd4u3XcPWCvDSrnaBPlUcMQ==", "funding": [ { "type": "github", @@ -1332,6 +1346,8 @@ } ], "dependencies": { + "fast-xml-builder": "^1.1.0", + "path-expression-matcher": "^1.1.2", "strnum": "^2.1.2" }, "bin": { @@ -2415,6 +2431,20 @@ "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==", "license": "MIT" }, + "node_modules/path-expression-matcher": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.1.2.tgz", + "integrity": "sha512-LXWqJmcpp2BKOEmgt4CyuESFmBfPuhJlAHKJsFzuJU6CxErWk75BrO+Ni77M9OxHN6dCYKM4vj+21Z6cOL96YQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "engines": { + "node": ">=14.0.0" + } + }, "node_modules/path-is-absolute": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", @@ -4355,11 +4385,21 @@ "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", "peer": true }, + "fast-xml-builder": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.0.tgz", + "integrity": "sha512-7mtITW/we2/wTUZqMyBOR2F8xP4CRxMiSEcQxPIqdRWdO2L/HZSOlzoNyghmyDwNB8BDxePooV1ZTJpkOUhdRg==", + "requires": { + "path-expression-matcher": "^1.1.2" + } + }, "fast-xml-parser": { - "version": "5.3.7", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.3.7.tgz", - "integrity": "sha512-JzVLro9NQv92pOM/jTCR6mHlJh2FGwtomH8ZQjhFj/R29P2Fnj38OgPJVtcvYw6SuKClhgYuwUZf5b3rd8u2mA==", + "version": "5.5.1", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.1.tgz", + "integrity": "sha512-JTpMz8P5mDoNYzXTmTT/xzWjFiCWi0U+UQTJtrFH9muXsr2RqtXZPbnCW5h2mKsOd4u3XcPWCvDSrnaBPlUcMQ==", "requires": { + "fast-xml-builder": "^1.1.0", + "path-expression-matcher": "^1.1.2", "strnum": "^2.1.2" } }, @@ -5101,6 +5141,11 @@ "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz", "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==" }, + "path-expression-matcher": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.1.2.tgz", + "integrity": "sha512-LXWqJmcpp2BKOEmgt4CyuESFmBfPuhJlAHKJsFzuJU6CxErWk75BrO+Ni77M9OxHN6dCYKM4vj+21Z6cOL96YQ==" + }, "path-is-absolute": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", From 2647f5398e8102ee0fa7948458ca880e79cd6f9f Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 00:05:52 +0000 Subject: [PATCH 25/55] npm(deps): bump @types/node from 24.10.1 to 25.4.0 Bumps [@types/node](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/node) from 24.10.1 to 25.4.0. - [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases) - [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/node) --- updated-dependencies: - dependency-name: "@types/node" dependency-version: 25.4.0 dependency-type: indirect update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] --- package-lock.json | 28 ++++++++++++++-------------- 1 file changed, 14 insertions(+), 14 deletions(-) diff --git a/package-lock.json b/package-lock.json index fafd4a13d..85d436ea3 100644 --- a/package-lock.json +++ b/package-lock.json @@ -607,11 +607,11 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "24.10.1", - "resolved": "https://registry.npmjs.org/@types/node/-/node-24.10.1.tgz", - "integrity": "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ==", + "version": "25.4.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.4.0.tgz", + "integrity": "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw==", "dependencies": { - "undici-types": "~7.16.0" + "undici-types": "~7.18.0" } }, "node_modules/@types/stylis": { @@ -3220,9 +3220,9 @@ } }, "node_modules/undici-types": { - "version": "7.16.0", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz", - "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==" + "version": "7.18.2", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", + "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==" }, "node_modules/uri-js-replace": { "version": "1.0.1", @@ -3846,11 +3846,11 @@ "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==" }, "@types/node": { - "version": "24.10.1", - "resolved": "https://registry.npmjs.org/@types/node/-/node-24.10.1.tgz", - "integrity": "sha512-GNWcUTRBgIRJD5zj+Tq0fKOJ5XZajIiBroOF0yvj2bSU1WvNdYS/dn9UxwsujGW4JX06dnHyjV2y9rRaybH0iQ==", + "version": "25.4.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.4.0.tgz", + "integrity": "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw==", "requires": { - "undici-types": "~7.16.0" + "undici-types": "~7.18.0" } }, "@types/stylis": { @@ -5669,9 +5669,9 @@ "integrity": "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g==" }, "undici-types": { - "version": "7.16.0", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.16.0.tgz", - "integrity": "sha512-Zz+aZWSj8LE6zoxD+xrjh4VfkIG8Ya6LvYkZqtUQGJPZjYl53ypCaUwWqo7eI0x66KBGeRo+mlBEkMSeSZ38Nw==" + "version": "7.18.2", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", + "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==" }, "uri-js-replace": { "version": "1.0.1", From e7503ccc44e06bfadfbdce5af66c99d89d9bcfb0 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 11 Mar 2026 00:05:57 +0000 Subject: [PATCH 26/55] npm(deps): bump openapi-sampler from 1.7.0 to 1.7.2 Bumps [openapi-sampler](https://github.com/Redocly/openapi-sampler) from 1.7.0 to 1.7.2. - [Release notes](https://github.com/Redocly/openapi-sampler/releases) - [Changelog](https://github.com/Redocly/openapi-sampler/blob/main/CHANGELOG.md) - [Commits](https://github.com/Redocly/openapi-sampler/commits/v1.7.2) --- updated-dependencies: - dependency-name: openapi-sampler dependency-version: 1.7.2 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 85 ++++++++++++++++++++++++++++++++++++----------- 1 file changed, 65 insertions(+), 20 deletions(-) diff --git a/package-lock.json b/package-lock.json index fafd4a13d..c0a9ec877 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1321,10 +1321,24 @@ ], "peer": true }, + "node_modules/fast-xml-builder": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.0.tgz", + "integrity": "sha512-7mtITW/we2/wTUZqMyBOR2F8xP4CRxMiSEcQxPIqdRWdO2L/HZSOlzoNyghmyDwNB8BDxePooV1ZTJpkOUhdRg==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "dependencies": { + "path-expression-matcher": "^1.1.2" + } + }, "node_modules/fast-xml-parser": { - "version": "5.3.7", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.3.7.tgz", - "integrity": "sha512-JzVLro9NQv92pOM/jTCR6mHlJh2FGwtomH8ZQjhFj/R29P2Fnj38OgPJVtcvYw6SuKClhgYuwUZf5b3rd8u2mA==", + "version": "5.5.1", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.1.tgz", + "integrity": "sha512-JTpMz8P5mDoNYzXTmTT/xzWjFiCWi0U+UQTJtrFH9muXsr2RqtXZPbnCW5h2mKsOd4u3XcPWCvDSrnaBPlUcMQ==", "funding": [ { "type": "github", @@ -1332,6 +1346,8 @@ } ], "dependencies": { + "fast-xml-builder": "^1.1.0", + "path-expression-matcher": "^1.1.2", "strnum": "^2.1.2" }, "bin": { @@ -2367,12 +2383,12 @@ } }, "node_modules/openapi-sampler": { - "version": "1.7.0", - "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.0.tgz", - "integrity": "sha512-fWq32F5vqGpgRJYIarC/9Y1wC9tKnRDcCOjsDJ7MIcSv2HsE7kNifcXIZ8FVtNStBUWxYrEk/MKqVF0SwZ5gog==", + "version": "1.7.2", + "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.2.tgz", + "integrity": "sha512-OKytvqB5XIaTgA9xtw8W8UTar+uymW2xPVpFN0NihMtuHPdPTGxBEhGnfFnJW5g/gOSIvkP+H0Xh3XhVI9/n7g==", "dependencies": { "@types/json-schema": "^7.0.7", - "fast-xml-parser": "^5.3.4", + "fast-xml-parser": "^5.5.1", "json-pointer": "0.6.2" } }, @@ -2415,6 +2431,20 @@ "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==", "license": "MIT" }, + "node_modules/path-expression-matcher": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.1.2.tgz", + "integrity": "sha512-LXWqJmcpp2BKOEmgt4CyuESFmBfPuhJlAHKJsFzuJU6CxErWk75BrO+Ni77M9OxHN6dCYKM4vj+21Z6cOL96YQ==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "engines": { + "node": ">=14.0.0" + } + }, "node_modules/path-is-absolute": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", @@ -3067,9 +3097,9 @@ } }, "node_modules/strnum": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.1.2.tgz", - "integrity": "sha512-l63NF9y/cLROq/yqKXSLtcMeeyOfnSQlfMSlzFt/K73oIaD8DGaQWd7Z34X9GPiKqP5rbSh84Hl4bOlLcjiSrQ==", + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.0.tgz", + "integrity": "sha512-Y7Bj8XyJxnPAORMZj/xltsfo55uOiyHcU2tnAVzHUnSJR/KsEX+9RoDeXEnsXtl/CX4fAcrt64gZ13aGaWPeBg==", "funding": [ { "type": "github", @@ -4355,11 +4385,21 @@ "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", "peer": true }, + "fast-xml-builder": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.0.tgz", + "integrity": "sha512-7mtITW/we2/wTUZqMyBOR2F8xP4CRxMiSEcQxPIqdRWdO2L/HZSOlzoNyghmyDwNB8BDxePooV1ZTJpkOUhdRg==", + "requires": { + "path-expression-matcher": "^1.1.2" + } + }, "fast-xml-parser": { - "version": "5.3.7", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.3.7.tgz", - "integrity": "sha512-JzVLro9NQv92pOM/jTCR6mHlJh2FGwtomH8ZQjhFj/R29P2Fnj38OgPJVtcvYw6SuKClhgYuwUZf5b3rd8u2mA==", + "version": "5.5.1", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.1.tgz", + "integrity": "sha512-JTpMz8P5mDoNYzXTmTT/xzWjFiCWi0U+UQTJtrFH9muXsr2RqtXZPbnCW5h2mKsOd4u3XcPWCvDSrnaBPlUcMQ==", "requires": { + "fast-xml-builder": "^1.1.0", + "path-expression-matcher": "^1.1.2", "strnum": "^2.1.2" } }, @@ -5060,12 +5100,12 @@ } }, "openapi-sampler": { - "version": "1.7.0", - "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.0.tgz", - "integrity": "sha512-fWq32F5vqGpgRJYIarC/9Y1wC9tKnRDcCOjsDJ7MIcSv2HsE7kNifcXIZ8FVtNStBUWxYrEk/MKqVF0SwZ5gog==", + "version": "1.7.2", + "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.2.tgz", + "integrity": "sha512-OKytvqB5XIaTgA9xtw8W8UTar+uymW2xPVpFN0NihMtuHPdPTGxBEhGnfFnJW5g/gOSIvkP+H0Xh3XhVI9/n7g==", "requires": { "@types/json-schema": "^7.0.7", - "fast-xml-parser": "^5.3.4", + "fast-xml-parser": "^5.5.1", "json-pointer": "0.6.2" } }, @@ -5101,6 +5141,11 @@ "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz", "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==" }, + "path-expression-matcher": { + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.1.2.tgz", + "integrity": "sha512-LXWqJmcpp2BKOEmgt4CyuESFmBfPuhJlAHKJsFzuJU6CxErWk75BrO+Ni77M9OxHN6dCYKM4vj+21Z6cOL96YQ==" + }, "path-is-absolute": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", @@ -5570,9 +5615,9 @@ } }, "strnum": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.1.2.tgz", - "integrity": "sha512-l63NF9y/cLROq/yqKXSLtcMeeyOfnSQlfMSlzFt/K73oIaD8DGaQWd7Z34X9GPiKqP5rbSh84Hl4bOlLcjiSrQ==" + "version": "2.2.0", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.0.tgz", + "integrity": "sha512-Y7Bj8XyJxnPAORMZj/xltsfo55uOiyHcU2tnAVzHUnSJR/KsEX+9RoDeXEnsXtl/CX4fAcrt64gZ13aGaWPeBg==" }, "styled-components": { "version": "6.1.19", From 30def6eb4d3632dbf3f0c384507194d22e64c86b Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Mon, 9 Mar 2026 15:57:11 +0000 Subject: [PATCH 27/55] Testing build pipeline From b89f74daa9469dd13935c7fb48bec20b6ec186cf Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Tue, 17 Mar 2026 12:05:46 +0000 Subject: [PATCH 28/55] [RAA-1218]-[GC]-[Updated integration tests for working RC user]-[EW] --- tests/conftest.py | 2 +- tests/data.py | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/tests/conftest.py b/tests/conftest.py index fef43b4bd..b452f4c2e 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -110,7 +110,7 @@ def app_restricted_ods_code(is_mocked_environment): @pytest.fixture(scope="session") def app_restricted_user_id(is_mocked_environment): - return "000000000101" if is_mocked_environment else "555032000100" + return "000000000101" if is_mocked_environment else "555073103100" @pytest.fixture( diff --git a/tests/data.py b/tests/data.py index c638801cf..37f04ba7a 100644 --- a/tests/data.py +++ b/tests/data.py @@ -15,7 +15,7 @@ class UserAuthenticationLevel(Enum): class Actor(Enum): # User ID, org code, business function, IAL, AAL, OBO User ID (optional) RC = ( - "555032000100", + "555073103100", "D82106", "REFERRING_CLINICIAN", "3", From c1026b593de1246ebf3f54c1f62d763f73094926 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 18 Mar 2026 10:11:04 +0000 Subject: [PATCH 29/55] Dependabot updates --- poetry.lock | 134 +++++++++++++++++++++++++++++++++---------------- pyproject.toml | 2 +- 2 files changed, 91 insertions(+), 45 deletions(-) diff --git a/poetry.lock b/poetry.lock index 7a053c812..d57e3fc4a 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand. +# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand. [[package]] name = "annotated-types" @@ -26,14 +26,14 @@ files = [ [[package]] name = "authlib" -version = "1.6.7" +version = "1.6.9" description = "The ultimate Python library in building OAuth and OpenID Connect servers and clients." optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "authlib-1.6.7-py2.py3-none-any.whl", hash = "sha256:c637340d9a02789d2efa1d003a7437d10d3e565237bcb5fcbc6c134c7b95bab0"}, - {file = "authlib-1.6.7.tar.gz", hash = "sha256:dbf10100011d1e1b34048c9d120e83f13b35d69a826ae762b93d2fb5aafc337b"}, + {file = "authlib-1.6.9-py2.py3-none-any.whl", hash = "sha256:f08b4c14e08f0861dc18a32357b33fbcfd2ea86cfe3fe149484b4d764c4a0ac3"}, + {file = "authlib-1.6.9.tar.gz", hash = "sha256:d8f2421e7e5980cc1ddb4e32d3f5fa659cfaf60d8eaf3281ebed192e4ab74f04"}, ] [package.dependencies] @@ -41,54 +41,54 @@ cryptography = "*" [[package]] name = "black" -version = "25.12.0" +version = "26.3.1" description = "The uncompromising code formatter." optional = false python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "black-25.12.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f85ba1ad15d446756b4ab5f3044731bf68b777f8f9ac9cdabd2425b97cd9c4e8"}, - {file = "black-25.12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:546eecfe9a3a6b46f9d69d8a642585a6eaf348bcbbc4d87a19635570e02d9f4a"}, - {file = "black-25.12.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:17dcc893da8d73d8f74a596f64b7c98ef5239c2cd2b053c0f25912c4494bf9ea"}, - {file = "black-25.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:09524b0e6af8ba7a3ffabdfc7a9922fb9adef60fed008c7cd2fc01f3048e6e6f"}, - {file = "black-25.12.0-cp310-cp310-win_arm64.whl", hash = "sha256:b162653ed89eb942758efeb29d5e333ca5bb90e5130216f8369857db5955a7da"}, - {file = "black-25.12.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d0cfa263e85caea2cff57d8f917f9f51adae8e20b610e2b23de35b5b11ce691a"}, - {file = "black-25.12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1a2f578ae20c19c50a382286ba78bfbeafdf788579b053d8e4980afb079ab9be"}, - {file = "black-25.12.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d3e1b65634b0e471d07ff86ec338819e2ef860689859ef4501ab7ac290431f9b"}, - {file = "black-25.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:a3fa71e3b8dd9f7c6ac4d818345237dfb4175ed3bf37cd5a581dbc4c034f1ec5"}, - {file = "black-25.12.0-cp311-cp311-win_arm64.whl", hash = "sha256:51e267458f7e650afed8445dc7edb3187143003d52a1b710c7321aef22aa9655"}, - {file = "black-25.12.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:31f96b7c98c1ddaeb07dc0f56c652e25bdedaac76d5b68a059d998b57c55594a"}, - {file = "black-25.12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:05dd459a19e218078a1f98178c13f861fe6a9a5f88fc969ca4d9b49eb1809783"}, - {file = "black-25.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1f68c5eff61f226934be6b5b80296cf6939e5d2f0c2f7d543ea08b204bfaf59"}, - {file = "black-25.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:274f940c147ddab4442d316b27f9e332ca586d39c85ecf59ebdea82cc9ee8892"}, - {file = "black-25.12.0-cp312-cp312-win_arm64.whl", hash = "sha256:169506ba91ef21e2e0591563deda7f00030cb466e747c4b09cb0a9dae5db2f43"}, - {file = "black-25.12.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:a05ddeb656534c3e27a05a29196c962877c83fa5503db89e68857d1161ad08a5"}, - {file = "black-25.12.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:9ec77439ef3e34896995503865a85732c94396edcc739f302c5673a2315e1e7f"}, - {file = "black-25.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e509c858adf63aa61d908061b52e580c40eae0dfa72415fa47ac01b12e29baf"}, - {file = "black-25.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:252678f07f5bac4ff0d0e9b261fbb029fa530cfa206d0a636a34ab445ef8ca9d"}, - {file = "black-25.12.0-cp313-cp313-win_arm64.whl", hash = "sha256:bc5b1c09fe3c931ddd20ee548511c64ebf964ada7e6f0763d443947fd1c603ce"}, - {file = "black-25.12.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:0a0953b134f9335c2434864a643c842c44fba562155c738a2a37a4d61f00cad5"}, - {file = "black-25.12.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:2355bbb6c3b76062870942d8cc450d4f8ac71f9c93c40122762c8784df49543f"}, - {file = "black-25.12.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9678bd991cc793e81d19aeeae57966ee02909877cb65838ccffef24c3ebac08f"}, - {file = "black-25.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:97596189949a8aad13ad12fcbb4ae89330039b96ad6742e6f6b45e75ad5cfd83"}, - {file = "black-25.12.0-cp314-cp314-win_arm64.whl", hash = "sha256:778285d9ea197f34704e3791ea9404cd6d07595745907dd2ce3da7a13627b29b"}, - {file = "black-25.12.0-py3-none-any.whl", hash = "sha256:48ceb36c16dbc84062740049eef990bb2ce07598272e673c17d1a7720c71c828"}, - {file = "black-25.12.0.tar.gz", hash = "sha256:8d3dd9cea14bff7ddc0eb243c811cdb1a011ebb4800a5f0335a01a68654796a7"}, + {file = "black-26.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:86a8b5035fce64f5dcd1b794cf8ec4d31fe458cf6ce3986a30deb434df82a1d2"}, + {file = "black-26.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5602bdb96d52d2d0672f24f6ffe5218795736dd34807fd0fd55ccd6bf206168b"}, + {file = "black-26.3.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6c54a4a82e291a1fee5137371ab488866b7c86a3305af4026bdd4dc78642e1ac"}, + {file = "black-26.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:6e131579c243c98f35bce64a7e08e87fb2d610544754675d4a0e73a070a5aa3a"}, + {file = "black-26.3.1-cp310-cp310-win_arm64.whl", hash = "sha256:5ed0ca58586c8d9a487352a96b15272b7fa55d139fc8496b519e78023a8dab0a"}, + {file = "black-26.3.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:28ef38aee69e4b12fda8dba75e21f9b4f979b490c8ac0baa7cb505369ac9e1ff"}, + {file = "black-26.3.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:bf9bf162ed91a26f1adba8efda0b573bc6924ec1408a52cc6f82cb73ec2b142c"}, + {file = "black-26.3.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:474c27574d6d7037c1bc875a81d9be0a9a4f9ee95e62800dab3cfaadbf75acd5"}, + {file = "black-26.3.1-cp311-cp311-win_amd64.whl", hash = "sha256:5e9d0d86df21f2e1677cc4bd090cd0e446278bcbbe49bf3659c308c3e402843e"}, + {file = "black-26.3.1-cp311-cp311-win_arm64.whl", hash = "sha256:9a5e9f45e5d5e1c5b5c29b3bd4265dcc90e8b92cf4534520896ed77f791f4da5"}, + {file = "black-26.3.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b5e6f89631eb88a7302d416594a32faeee9fb8fb848290da9d0a5f2903519fc1"}, + {file = "black-26.3.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:41cd2012d35b47d589cb8a16faf8a32ef7a336f56356babd9fcf70939ad1897f"}, + {file = "black-26.3.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f76ff19ec5297dd8e66eb64deda23631e642c9393ab592826fd4bdc97a4bce7"}, + {file = "black-26.3.1-cp312-cp312-win_amd64.whl", hash = "sha256:ddb113db38838eb9f043623ba274cfaf7d51d5b0c22ecb30afe58b1bb8322983"}, + {file = "black-26.3.1-cp312-cp312-win_arm64.whl", hash = "sha256:dfdd51fc3e64ea4f35873d1b3fb25326773d55d2329ff8449139ebaad7357efb"}, + {file = "black-26.3.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:855822d90f884905362f602880ed8b5df1b7e3ee7d0db2502d4388a954cc8c54"}, + {file = "black-26.3.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:8a33d657f3276328ce00e4d37fe70361e1ec7614da5d7b6e78de5426cb56332f"}, + {file = "black-26.3.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f1cd08e99d2f9317292a311dfe578fd2a24b15dbce97792f9c4d752275c1fa56"}, + {file = "black-26.3.1-cp313-cp313-win_amd64.whl", hash = "sha256:c7e72339f841b5a237ff14f7d3880ddd0fc7f98a1199e8c4327f9a4f478c1839"}, + {file = "black-26.3.1-cp313-cp313-win_arm64.whl", hash = "sha256:afc622538b430aa4c8c853f7f63bc582b3b8030fd8c80b70fb5fa5b834e575c2"}, + {file = "black-26.3.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:2d6bfaf7fd0993b420bed691f20f9492d53ce9a2bcccea4b797d34e947318a78"}, + {file = "black-26.3.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:f89f2ab047c76a9c03f78d0d66ca519e389519902fa27e7a91117ef7611c0568"}, + {file = "black-26.3.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b07fc0dab849d24a80a29cfab8d8a19187d1c4685d8a5e6385a5ce323c1f015f"}, + {file = "black-26.3.1-cp314-cp314-win_amd64.whl", hash = "sha256:0126ae5b7c09957da2bdbd91a9ba1207453feada9e9fe51992848658c6c8e01c"}, + {file = "black-26.3.1-cp314-cp314-win_arm64.whl", hash = "sha256:92c0ec1f2cc149551a2b7b47efc32c866406b6891b0ee4625e95967c8f4acfb1"}, + {file = "black-26.3.1-py3-none-any.whl", hash = "sha256:2bd5aa94fc267d38bb21a70d7410a89f1a1d318841855f698746f8e7f51acd1b"}, + {file = "black-26.3.1.tar.gz", hash = "sha256:2c50f5063a9641c7eed7795014ba37b0f5fa227f3d408b968936e24bc0566b07"}, ] [package.dependencies] click = ">=8.0.0" mypy-extensions = ">=0.4.3" packaging = ">=22.0" -pathspec = ">=0.9.0" +pathspec = ">=1.0.0" platformdirs = ">=2" -pytokens = ">=0.3.0" +pytokens = ">=0.4.0,<0.5.0" [package.extras] colorama = ["colorama (>=0.4.3)"] d = ["aiohttp (>=3.10)"] jupyter = ["ipython (>=7.8.0)", "tokenize-rt (>=3.2.0)"] -uvloop = ["uvloop (>=0.15.2)"] +uvloop = ["uvloop (>=0.15.2) ; sys_platform != \"win32\"", "winloop (>=0.5.0) ; sys_platform == \"win32\""] [[package]] name = "certifi" @@ -584,7 +584,7 @@ files = [ [package.dependencies] attrs = ">=22.2.0" -jsonschema-specifications = ">=2023.03.6" +jsonschema-specifications = ">=2023.3.6" referencing = ">=0.28.4" rpds-py = ">=0.7.1" @@ -1068,16 +1068,22 @@ files = [ [[package]] name = "pathspec" -version = "0.12.1" +version = "1.0.4" description = "Utility library for gitignore style pattern matching of file paths." optional = false -python-versions = ">=3.8" +python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08"}, - {file = "pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712"}, + {file = "pathspec-1.0.4-py3-none-any.whl", hash = "sha256:fb6ae2fd4e7c921a165808a552060e722767cfa526f99ca5156ed2ce45a5c723"}, + {file = "pathspec-1.0.4.tar.gz", hash = "sha256:0210e2ae8a21a9137c0d470578cb0e595af87edaa6ebf12ff176f14a02e0e645"}, ] +[package.extras] +hyperscan = ["hyperscan (>=0.7)"] +optional = ["typing-extensions (>=4)"] +re2 = ["google-re2 (>=1.1)"] +tests = ["pytest (>=9)", "typing-extensions (>=4.15)"] + [[package]] name = "pip-licenses" version = "5.5.0" @@ -1580,14 +1586,54 @@ cli = ["click (>=5.0)"] [[package]] name = "pytokens" -version = "0.3.0" +version = "0.4.1" description = "A Fast, spec compliant Python 3.14+ tokenizer that runs on older Pythons." optional = false python-versions = ">=3.8" groups = ["dev"] files = [ - {file = "pytokens-0.3.0-py3-none-any.whl", hash = "sha256:95b2b5eaf832e469d141a378872480ede3f251a5a5041b8ec6e581d3ac71bbf3"}, - {file = "pytokens-0.3.0.tar.gz", hash = "sha256:2f932b14ed08de5fcf0b391ace2642f858f1394c0857202959000b68ed7a458a"}, + {file = "pytokens-0.4.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:2a44ed93ea23415c54f3face3b65ef2b844d96aeb3455b8a69b3df6beab6acc5"}, + {file = "pytokens-0.4.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:add8bf86b71a5d9fb5b89f023a80b791e04fba57960aa790cc6125f7f1d39dfe"}, + {file = "pytokens-0.4.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:670d286910b531c7b7e3c0b453fd8156f250adb140146d234a82219459b9640c"}, + {file = "pytokens-0.4.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:4e691d7f5186bd2842c14813f79f8884bb03f5995f0575272009982c5ac6c0f7"}, + {file = "pytokens-0.4.1-cp310-cp310-win_amd64.whl", hash = "sha256:27b83ad28825978742beef057bfe406ad6ed524b2d28c252c5de7b4a6dd48fa2"}, + {file = "pytokens-0.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:d70e77c55ae8380c91c0c18dea05951482e263982911fc7410b1ffd1dadd3440"}, + {file = "pytokens-0.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4a58d057208cb9075c144950d789511220b07636dd2e4708d5645d24de666bdc"}, + {file = "pytokens-0.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b49750419d300e2b5a3813cf229d4e5a4c728dae470bcc89867a9ad6f25a722d"}, + {file = "pytokens-0.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:d9907d61f15bf7261d7e775bd5d7ee4d2930e04424bab1972591918497623a16"}, + {file = "pytokens-0.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:ee44d0f85b803321710f9239f335aafe16553b39106384cef8e6de40cb4ef2f6"}, + {file = "pytokens-0.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:140709331e846b728475786df8aeb27d24f48cbcf7bcd449f8de75cae7a45083"}, + {file = "pytokens-0.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6d6c4268598f762bc8e91f5dbf2ab2f61f7b95bdc07953b602db879b3c8c18e1"}, + {file = "pytokens-0.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:24afde1f53d95348b5a0eb19488661147285ca4dd7ed752bbc3e1c6242a304d1"}, + {file = "pytokens-0.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5ad948d085ed6c16413eb5fec6b3e02fa00dc29a2534f088d3302c47eb59adf9"}, + {file = "pytokens-0.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:3f901fe783e06e48e8cbdc82d631fca8f118333798193e026a50ce1b3757ea68"}, + {file = "pytokens-0.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:8bdb9d0ce90cbf99c525e75a2fa415144fd570a1ba987380190e8b786bc6ef9b"}, + {file = "pytokens-0.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5502408cab1cb18e128570f8d598981c68a50d0cbd7c61312a90507cd3a1276f"}, + {file = "pytokens-0.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:29d1d8fb1030af4d231789959f21821ab6325e463f0503a61d204343c9b355d1"}, + {file = "pytokens-0.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:970b08dd6b86058b6dc07efe9e98414f5102974716232d10f32ff39701e841c4"}, + {file = "pytokens-0.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:9bd7d7f544d362576be74f9d5901a22f317efc20046efe2034dced238cbbfe78"}, + {file = "pytokens-0.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4a14d5f5fc78ce85e426aa159489e2d5961acf0e47575e08f35584009178e321"}, + {file = "pytokens-0.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:97f50fd18543be72da51dd505e2ed20d2228c74e0464e4262e4899797803d7fa"}, + {file = "pytokens-0.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:dc74c035f9bfca0255c1af77ddd2d6ae8419012805453e4b0e7513e17904545d"}, + {file = "pytokens-0.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f66a6bbe741bd431f6d741e617e0f39ec7257ca1f89089593479347cc4d13324"}, + {file = "pytokens-0.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:b35d7e5ad269804f6697727702da3c517bb8a5228afa450ab0fa787732055fc9"}, + {file = "pytokens-0.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:8fcb9ba3709ff77e77f1c7022ff11d13553f3c30299a9fe246a166903e9091eb"}, + {file = "pytokens-0.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:79fc6b8699564e1f9b521582c35435f1bd32dd06822322ec44afdeba666d8cb3"}, + {file = "pytokens-0.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d31b97b3de0f61571a124a00ffe9a81fb9939146c122c11060725bd5aea79975"}, + {file = "pytokens-0.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:967cf6e3fd4adf7de8fc73cd3043754ae79c36475c1c11d514fc72cf5490094a"}, + {file = "pytokens-0.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:584c80c24b078eec1e227079d56dc22ff755e0ba8654d8383b2c549107528918"}, + {file = "pytokens-0.4.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:da5baeaf7116dced9c6bb76dc31ba04a2dc3695f3d9f74741d7910122b456edc"}, + {file = "pytokens-0.4.1-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:11edda0942da80ff58c4408407616a310adecae1ddd22eef8c692fe266fa5009"}, + {file = "pytokens-0.4.1-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0fc71786e629cef478cbf29d7ea1923299181d0699dbe7c3c0f4a583811d9fc1"}, + {file = "pytokens-0.4.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:dcafc12c30dbaf1e2af0490978352e0c4041a7cde31f4f81435c2a5e8b9cabb6"}, + {file = "pytokens-0.4.1-cp38-cp38-win_amd64.whl", hash = "sha256:42f144f3aafa5d92bad964d471a581651e28b24434d184871bd02e3a0d956037"}, + {file = "pytokens-0.4.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:34bcc734bd2f2d5fe3b34e7b3c0116bfb2397f2d9666139988e7a3eb5f7400e3"}, + {file = "pytokens-0.4.1-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:941d4343bf27b605e9213b26bfa1c4bf197c9c599a9627eb7305b0defcfe40c1"}, + {file = "pytokens-0.4.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3ad72b851e781478366288743198101e5eb34a414f1d5627cdd585ca3b25f1db"}, + {file = "pytokens-0.4.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:682fa37ff4d8e95f7df6fe6fe6a431e8ed8e788023c6bcc0f0880a12eab80ad1"}, + {file = "pytokens-0.4.1-cp39-cp39-win_amd64.whl", hash = "sha256:30f51edd9bb7f85c748979384165601d028b84f7bd13fe14d3e065304093916a"}, + {file = "pytokens-0.4.1-py3-none-any.whl", hash = "sha256:26cef14744a8385f35d0e095dc8b3a7583f6c953c2e3d269c7f82484bf5ad2de"}, + {file = "pytokens-0.4.1.tar.gz", hash = "sha256:292052fe80923aae2260c073f822ceba21f3872ced9a68bb7953b348e561179a"}, ] [package.extras] @@ -2028,4 +2074,4 @@ files = [ [metadata] lock-version = "2.1" python-versions = "^3.13" -content-hash = "e65afc48136d4b5b3172965f3f0395322338d8f975a2d0910c062f2aef4a4e7e" +content-hash = "81074998cbe73d0e8c7ce2898659e563bbc9141fa93a9dbb7d4a8a5b83f34686" diff --git a/pyproject.toml b/pyproject.toml index eaae2e6e3..2e092c236 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -35,7 +35,7 @@ openapi-core = "^0.19.5" [tool.poetry.group.dev.dependencies] flake8 = "^7.3.0" -black = "^25.11" +black = "^26.3.1" pip-licenses = "^5.5.0" jinja2 = "^3.1.6" pytest = "^8.4.2" From f9ca6157225ea4cad31288ac3c1e5f2d3f06b8a4 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 18 Mar 2026 10:52:21 +0000 Subject: [PATCH 30/55] [RAA-5746]-[GC]-[Dependabot poetry updates]-[EW] --- poetry.lock | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/poetry.lock b/poetry.lock index d57e3fc4a..82c7a3bc9 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1450,21 +1450,21 @@ windows-terminal = ["colorama (>=0.4.6)"] [[package]] name = "pyjwt" -version = "2.10.1" +version = "2.12.1" description = "JSON Web Token implementation in Python" optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "PyJWT-2.10.1-py3-none-any.whl", hash = "sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb"}, - {file = "pyjwt-2.10.1.tar.gz", hash = "sha256:3cc5772eb20009233caf06e9d8a0577824723b44e6648ee0a2aedb6cf9381953"}, + {file = "pyjwt-2.12.1-py3-none-any.whl", hash = "sha256:28ca37c070cad8ba8cd9790cd940535d40274d22f80ab87f3ac6a713e6e8454c"}, + {file = "pyjwt-2.12.1.tar.gz", hash = "sha256:c74a7a2adf861c04d002db713dd85f84beb242228e671280bf709d765b03672b"}, ] [package.extras] crypto = ["cryptography (>=3.4.0)"] -dev = ["coverage[toml] (==5.0.4)", "cryptography (>=3.4.0)", "pre-commit", "pytest (>=6.0.0,<7.0.0)", "sphinx", "sphinx-rtd-theme", "zope.interface"] +dev = ["coverage[toml] (==7.10.7)", "cryptography (>=3.4.0)", "pre-commit", "pytest (>=8.4.2,<9.0.0)", "sphinx", "sphinx-rtd-theme", "zope.interface"] docs = ["sphinx", "sphinx-rtd-theme", "zope.interface"] -tests = ["coverage[toml] (==5.0.4)", "pytest (>=6.0.0,<7.0.0)"] +tests = ["coverage[toml] (==7.10.7)", "pytest (>=8.4.2,<9.0.0)"] [[package]] name = "pyotp" From 49bd06b72cac13eda2fbdeaf2b59e710c1fbb010 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 18 Mar 2026 11:01:10 +0000 Subject: [PATCH 31/55] Update codeowners --- .github/CODEOWNERS | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index e9a3b666a..6c34f3a3f 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -9,11 +9,11 @@ # For version files that are updated by dependabot we have a cut down list -/sandbox/Dockerfile @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/sandbox/package.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/sandbox/package-lock.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/package.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/package-lock.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/poetry.lock @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/poetry.toml @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs -/pyproject.toml @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs +/sandbox/Dockerfile @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/sandbox/package.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/sandbox/package-lock.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/package.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/package-lock.json @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/poetry.lock @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/poetry.toml @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 +/pyproject.toml @daniel-mcadam-nhs @kevinmason-nhs @EdwardWills-nhs @georgeCraftReferrals @csaw-nhs @petkopetkov2 From 58f86b4d7c910b9ce37ce056d700720b665c8160 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 20 Mar 2026 09:38:31 +0000 Subject: [PATCH 32/55] Bump undici from 6.23.0 to 6.24.1 Bumps [undici](https://github.com/nodejs/undici) from 6.23.0 to 6.24.1. - [Release notes](https://github.com/nodejs/undici/releases) - [Commits](https://github.com/nodejs/undici/compare/v6.23.0...v6.24.1) --- updated-dependencies: - dependency-name: undici dependency-version: 6.24.1 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- package-lock.json | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/package-lock.json b/package-lock.json index f46fce2b0..8a0dfd55c 100644 --- a/package-lock.json +++ b/package-lock.json @@ -3242,9 +3242,9 @@ } }, "node_modules/undici": { - "version": "6.23.0", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.23.0.tgz", - "integrity": "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g==", + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.1.tgz", + "integrity": "sha512-sC+b0tB1whOCzbtlx20fx3WgCXwkW627p4EA9uM+/tNNPkSS+eSEld6pAs9nDv7WbY1UUljBMYPtu9BCOrCWKA==", "engines": { "node": ">=18.17" } @@ -5709,9 +5709,9 @@ "optional": true }, "undici": { - "version": "6.23.0", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.23.0.tgz", - "integrity": "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g==" + "version": "6.24.1", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.1.tgz", + "integrity": "sha512-sC+b0tB1whOCzbtlx20fx3WgCXwkW627p4EA9uM+/tNNPkSS+eSEld6pAs9nDv7WbY1UUljBMYPtu9BCOrCWKA==" }, "undici-types": { "version": "7.18.2", From f348bf840be03eade2cd5ff5283a825f6d144f2b Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Mon, 30 Mar 2026 12:31:49 +0100 Subject: [PATCH 33/55] [RAA-6144]-[GC]-[Bump npm and poetry dependencies]-[EW] --- node-deps.json | 977 ++++++++++++++++++++++++++ package-lock.json | 994 +++++++++++++------------- poetry.lock | 482 ++++++------- sandbox/package-lock.json | 1380 ++++++------------------------------- sandbox/python-deps.txt | 161 +++++ 5 files changed, 2126 insertions(+), 1868 deletions(-) create mode 100644 node-deps.json create mode 100644 sandbox/python-deps.txt diff --git a/node-deps.json b/node-deps.json new file mode 100644 index 000000000..8b78ae9f5 --- /dev/null +++ b/node-deps.json @@ -0,0 +1,977 @@ +{ + "version": "1.0.0", + "name": "e-referrals-service-api-sandbox", + "problems": [ + "invalid: globals@16.5.0 /home/ers/git/e-referrals-service-api/sandbox/node_modules/globals" + ], + "dependencies": { + "@hapi/hapi": { + "version": "21.4.4", + "resolved": "https://registry.npmjs.org/@hapi/hapi/-/hapi-21.4.4.tgz", + "overridden": false, + "dependencies": { + "@hapi/accept": { + "version": "6.0.3", + "resolved": "https://registry.npmjs.org/@hapi/accept/-/accept-6.0.3.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/ammo": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/@hapi/ammo/-/ammo-6.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/boom": { + "version": "10.0.1", + "resolved": "https://registry.npmjs.org/@hapi/boom/-/boom-10.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/bounce": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/@hapi/bounce/-/bounce-3.0.2.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/call": { + "version": "9.0.1", + "resolved": "https://registry.npmjs.org/@hapi/call/-/call-9.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/catbox-memory": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/@hapi/catbox-memory/-/catbox-memory-6.0.2.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/catbox": { + "version": "12.1.1", + "resolved": "https://registry.npmjs.org/@hapi/catbox/-/catbox-12.1.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/podium": { + "version": "5.0.2" + }, + "@hapi/validate": { + "version": "2.0.1" + } + } + }, + "@hapi/heavy": { + "version": "8.0.1", + "resolved": "https://registry.npmjs.org/@hapi/heavy/-/heavy-8.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/validate": { + "version": "2.0.1" + } + } + }, + "@hapi/hoek": { + "version": "11.0.7", + "resolved": "https://registry.npmjs.org/@hapi/hoek/-/hoek-11.0.7.tgz", + "overridden": false + }, + "@hapi/mimos": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/@hapi/mimos/-/mimos-7.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + }, + "mime-db": { + "version": "1.54.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", + "overridden": false + } + } + }, + "@hapi/podium": { + "version": "5.0.2", + "resolved": "https://registry.npmjs.org/@hapi/podium/-/podium-5.0.2.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/teamwork": { + "version": "6.0.1" + }, + "@hapi/validate": { + "version": "2.0.1" + } + } + }, + "@hapi/shot": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/@hapi/shot/-/shot-6.0.2.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/validate": { + "version": "2.0.1" + } + } + }, + "@hapi/somever": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/@hapi/somever/-/somever-4.1.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/bounce": { + "version": "3.0.2" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/statehood": { + "version": "8.2.1", + "resolved": "https://registry.npmjs.org/@hapi/statehood/-/statehood-8.2.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/bounce": { + "version": "3.0.2" + }, + "@hapi/bourne": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/@hapi/bourne/-/bourne-3.0.0.tgz", + "overridden": false + }, + "@hapi/cryptiles": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + } + } + }, + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/iron": { + "version": "7.0.1", + "resolved": "https://registry.npmjs.org/@hapi/iron/-/iron-7.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/b64": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/@hapi/b64/-/b64-6.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/bourne": { + "version": "3.0.0" + }, + "@hapi/cryptiles": { + "version": "6.0.1" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/validate": { + "version": "2.0.1" + } + } + }, + "@hapi/subtext": { + "version": "8.1.1", + "resolved": "https://registry.npmjs.org/@hapi/subtext/-/subtext-8.1.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/bourne": { + "version": "3.0.0" + }, + "@hapi/content": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.0.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + } + } + }, + "@hapi/file": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/@hapi/file/-/file-3.0.0.tgz", + "overridden": false + }, + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/pez": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/@hapi/pez/-/pez-6.1.0.tgz", + "overridden": false, + "dependencies": { + "@hapi/b64": { + "version": "6.0.1" + }, + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/content": { + "version": "6.0.0" + }, + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/nigel": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/@hapi/nigel/-/nigel-5.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/vise": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/@hapi/vise/-/vise-5.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + } + } + } + } + } + } + }, + "@hapi/wreck": { + "version": "18.1.0", + "resolved": "https://registry.npmjs.org/@hapi/wreck/-/wreck-18.1.0.tgz", + "overridden": false, + "dependencies": { + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/bourne": { + "version": "3.0.0" + }, + "@hapi/hoek": { + "version": "11.0.7" + } + } + } + } + }, + "@hapi/teamwork": { + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/@hapi/teamwork/-/teamwork-6.0.1.tgz", + "overridden": false + }, + "@hapi/topo": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/@hapi/topo/-/topo-6.0.2.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + } + } + }, + "@hapi/validate": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@hapi/validate/-/validate-2.0.1.tgz", + "overridden": false, + "dependencies": { + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/topo": { + "version": "6.0.2" + } + } + } + } + }, + "@hapi/inert": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/@hapi/inert/-/inert-7.1.0.tgz", + "overridden": false, + "dependencies": { + "@hapi/ammo": { + "version": "6.0.1" + }, + "@hapi/boom": { + "version": "10.0.1" + }, + "@hapi/bounce": { + "version": "3.0.2" + }, + "@hapi/hoek": { + "version": "11.0.7" + }, + "@hapi/validate": { + "version": "2.0.1" + }, + "lru-cache": { + "version": "7.18.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", + "overridden": false + } + } + }, + "eslint": { + "version": "9.25.1", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.25.1.tgz", + "overridden": false, + "dependencies": { + "@eslint-community/eslint-utils": { + "version": "4.9.0", + "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.0.tgz", + "overridden": false, + "dependencies": { + "eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "overridden": false + }, + "eslint": { + "version": "9.25.1" + } + } + }, + "@eslint-community/regexpp": { + "version": "4.12.2", + "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", + "overridden": false + }, + "@eslint/config-array": { + "version": "0.20.1", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.20.1.tgz", + "overridden": false, + "dependencies": { + "@eslint/object-schema": { + "version": "2.1.7", + "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", + "overridden": false + }, + "debug": { + "version": "4.4.3" + }, + "minimatch": { + "version": "3.1.5" + } + } + }, + "@eslint/config-helpers": { + "version": "0.2.3", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.2.3.tgz", + "overridden": false + }, + "@eslint/core": { + "version": "0.13.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.13.0.tgz", + "overridden": false, + "dependencies": { + "@types/json-schema": { + "version": "7.0.15" + } + } + }, + "@eslint/eslintrc": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.1.tgz", + "overridden": false, + "dependencies": { + "ajv": { + "version": "6.12.6" + }, + "debug": { + "version": "4.4.3" + }, + "espree": { + "version": "10.4.0" + }, + "globals": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", + "overridden": false + }, + "ignore": { + "version": "5.3.2" + }, + "import-fresh": { + "version": "3.3.1", + "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", + "overridden": false, + "dependencies": { + "parent-module": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", + "overridden": false, + "dependencies": { + "callsites": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", + "overridden": false + } + } + }, + "resolve-from": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", + "overridden": false + } + } + }, + "js-yaml": { + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "overridden": false, + "dependencies": { + "argparse": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", + "overridden": false + } + } + }, + "minimatch": { + "version": "3.1.5" + }, + "strip-json-comments": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", + "overridden": false + } + } + }, + "@eslint/js": { + "version": "9.25.1", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.25.1.tgz", + "overridden": false + }, + "@eslint/plugin-kit": { + "version": "0.2.8", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.2.8.tgz", + "overridden": false, + "dependencies": { + "@eslint/core": { + "version": "0.13.0" + }, + "levn": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", + "overridden": false, + "dependencies": { + "prelude-ls": { + "version": "1.2.1" + }, + "type-check": { + "version": "0.4.0" + } + } + } + } + }, + "@humanfs/node": { + "version": "0.16.7", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", + "overridden": false, + "dependencies": { + "@humanfs/core": { + "version": "0.19.1", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", + "overridden": false + }, + "@humanwhocodes/retry": { + "version": "0.4.3" + } + } + }, + "@humanwhocodes/module-importer": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", + "overridden": false + }, + "@humanwhocodes/retry": { + "version": "0.4.3", + "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", + "overridden": false + }, + "@types/estree": { + "version": "1.0.8", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", + "overridden": false + }, + "@types/json-schema": { + "version": "7.0.15", + "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", + "overridden": false + }, + "ajv": { + "version": "6.12.6", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", + "overridden": false, + "dependencies": { + "fast-deep-equal": { + "version": "3.1.3" + }, + "fast-json-stable-stringify": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", + "overridden": false + }, + "json-schema-traverse": { + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", + "overridden": false + }, + "uri-js": { + "version": "4.4.1", + "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", + "overridden": false, + "dependencies": { + "punycode": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", + "overridden": false + } + } + } + } + }, + "chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "overridden": false, + "dependencies": { + "ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "overridden": false, + "dependencies": { + "color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "overridden": false, + "dependencies": { + "color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "overridden": false + } + } + } + } + }, + "supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "overridden": false, + "dependencies": { + "has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "overridden": false + } + } + } + } + }, + "cross-spawn": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", + "overridden": false, + "dependencies": { + "path-key": { + "version": "3.1.1", + "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", + "overridden": false + }, + "shebang-command": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", + "overridden": false, + "dependencies": { + "shebang-regex": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", + "overridden": false + } + } + }, + "which": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", + "overridden": false, + "dependencies": { + "isexe": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", + "overridden": false + } + } + } + } + }, + "debug": { + "version": "4.4.3", + "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", + "overridden": false, + "dependencies": { + "ms": { + "version": "2.1.3", + "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", + "overridden": false + } + } + }, + "escape-string-regexp": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", + "overridden": false + }, + "eslint-scope": { + "version": "8.4.0", + "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", + "overridden": false, + "dependencies": { + "esrecurse": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", + "overridden": false, + "dependencies": { + "estraverse": { + "version": "5.3.0" + } + } + }, + "estraverse": { + "version": "5.3.0", + "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", + "overridden": false + } + } + }, + "eslint-visitor-keys": { + "version": "4.2.0", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.0.tgz", + "overridden": false + }, + "espree": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", + "overridden": false, + "dependencies": { + "acorn-jsx": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", + "overridden": false, + "dependencies": { + "acorn": { + "version": "8.15.0" + } + } + }, + "acorn": { + "version": "8.15.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", + "overridden": false + }, + "eslint-visitor-keys": { + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "overridden": false + } + } + }, + "esquery": { + "version": "1.6.0", + "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.6.0.tgz", + "overridden": false, + "dependencies": { + "estraverse": { + "version": "5.3.0" + } + } + }, + "esutils": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", + "overridden": false + }, + "fast-deep-equal": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", + "overridden": false + }, + "file-entry-cache": { + "version": "8.0.0", + "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", + "overridden": false, + "dependencies": { + "flat-cache": { + "version": "4.0.1", + "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", + "overridden": false, + "dependencies": { + "flatted": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", + "overridden": false + }, + "keyv": { + "version": "4.5.4", + "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", + "overridden": false, + "dependencies": { + "json-buffer": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", + "overridden": false + } + } + } + } + } + } + }, + "find-up": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", + "overridden": false, + "dependencies": { + "locate-path": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", + "overridden": false, + "dependencies": { + "p-locate": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", + "overridden": false, + "dependencies": { + "p-limit": { + "version": "3.1.0", + "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", + "overridden": false, + "dependencies": { + "yocto-queue": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", + "overridden": false + } + } + } + } + } + } + }, + "path-exists": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", + "overridden": false + } + } + }, + "glob-parent": { + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", + "overridden": false, + "dependencies": { + "is-glob": { + "version": "4.0.3" + } + } + }, + "ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "overridden": false + }, + "imurmurhash": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", + "overridden": false + }, + "is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "overridden": false, + "dependencies": { + "is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "overridden": false + } + } + }, + "jiti": {}, + "json-stable-stringify-without-jsonify": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", + "overridden": false + }, + "lodash.merge": { + "version": "4.6.2", + "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", + "overridden": false + }, + "minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "overridden": false, + "dependencies": { + "brace-expansion": { + "version": "1.1.12", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", + "overridden": false, + "dependencies": { + "balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "overridden": false + }, + "concat-map": { + "version": "0.0.1", + "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", + "overridden": false + } + } + } + } + }, + "natural-compare": { + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", + "overridden": false + }, + "optionator": { + "version": "0.9.4", + "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", + "overridden": false, + "dependencies": { + "deep-is": { + "version": "0.1.4", + "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", + "overridden": false + }, + "fast-levenshtein": { + "version": "2.0.6", + "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", + "overridden": false + }, + "levn": { + "version": "0.4.1" + }, + "prelude-ls": { + "version": "1.2.1", + "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", + "overridden": false + }, + "type-check": { + "version": "0.4.0", + "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", + "overridden": false, + "dependencies": { + "prelude-ls": { + "version": "1.2.1" + } + } + }, + "word-wrap": { + "version": "1.2.5", + "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", + "overridden": false + } + } + } + } + }, + "globals": { + "version": "16.5.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-16.5.0.tgz", + "overridden": false, + "invalid": "\"^17.0.0\" from the root project", + "problems": [ + "invalid: globals@16.5.0 /home/ers/git/e-referrals-service-api/sandbox/node_modules/globals" + ] + }, + "lodash": { + "version": "4.17.23", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", + "overridden": false + } + }, + "error": { + "code": "ELSPROBLEMS", + "summary": "invalid: globals@16.5.0 /home/ers/git/e-referrals-service-api/sandbox/node_modules/globals", + "detail": "" + } +} diff --git a/package-lock.json b/package-lock.json index 8a0dfd55c..3a3becc57 100644 --- a/package-lock.json +++ b/package-lock.json @@ -17,11 +17,12 @@ } }, "node_modules/@babel/code-frame": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", - "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", + "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==", + "license": "MIT", "dependencies": { - "@babel/helper-validator-identifier": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5", "js-tokens": "^4.0.0", "picocolors": "^1.1.1" }, @@ -33,6 +34,7 @@ "version": "7.28.5", "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==", + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -46,24 +48,24 @@ } }, "node_modules/@emotion/is-prop-valid": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-1.2.2.tgz", - "integrity": "sha512-uNsoYd37AFmaCdXlg6EYD1KaPOaRWRByMCYzbKUX4+hhMfrxdVSelShywL4JVaAeM/eHUOSprYBQls+/neX3pw==", + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-1.4.0.tgz", + "integrity": "sha512-QgD4fyscGcbbKwJmqNvUMSE02OsHUa+lAWKdEUIJKgqe5IwRSKd7+KhibEWdaKwgjLj0DRSHA9biAIqGBk05lw==", "license": "MIT", "dependencies": { - "@emotion/memoize": "^0.8.1" + "@emotion/memoize": "^0.9.0" } }, "node_modules/@emotion/memoize": { - "version": "0.8.1", - "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.8.1.tgz", - "integrity": "sha512-W2P2c/VRW1/1tLox0mVUalvnWXxavmv/Oum2aPsRcoDJuob75FC3Y8FbpfLwUegRcxINtGUMPq0tFCvYNTBXNA==", + "version": "0.9.0", + "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.9.0.tgz", + "integrity": "sha512-30FAj7/EoJ5mwVPOWhAyCX+FPfMDrVecJAM+Iw9NRoSl4BBAQeqj4cApHHUXOVvIPgLVDsCFoz/hGD+5QQD1GQ==", "license": "MIT" }, "node_modules/@emotion/unitless": { - "version": "0.8.1", - "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.8.1.tgz", - "integrity": "sha512-KOEGMu6dmJZtpadb476IsZBclKvILjopjUii3V+7MnXIQCYh8W3NgNcgwo21n9LXZX6EDIKvqfjYxXebDwxKmQ==", + "version": "0.10.0", + "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.10.0.tgz", + "integrity": "sha512-dFoMUuQA20zvtVTuxZww6OHoJYgrzfKM1t52mVySDJnMSEa08ruEvdYQbhvyu6soU+NeLVd3yKfTfT0NeV6qGg==", "license": "MIT" }, "node_modules/@exodus/schemasafe": { @@ -76,6 +78,7 @@ "version": "7.6.0", "resolved": "https://registry.npmjs.org/@faker-js/faker/-/faker-7.6.0.tgz", "integrity": "sha512-XK6BTq1NDMo9Xqw/YkYyGjSsg44fbNwYRx7QK2CuoQgyy+f1rrTDHoExVM5PsyXCtfl2vs2vVJ0MN0yN6LppRw==", + "license": "MIT", "engines": { "node": ">=14.0.0", "npm": ">=6.0.0" @@ -85,6 +88,7 @@ "version": "2.0.4", "resolved": "https://registry.npmjs.org/@humanwhocodes/momoa/-/momoa-2.0.4.tgz", "integrity": "sha512-RE815I4arJFtt+FVeU1Tgp9/Xvecacji8w/V6XtXsWWH/wz/eNkNbhb+ny/+PlVZjV0rxQpRSQKNKE3lcktHEA==", + "license": "Apache-2.0", "engines": { "node": ">=10.10.0" } @@ -93,6 +97,7 @@ "version": "29.6.3", "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", + "license": "MIT", "dependencies": { "@sinclair/typebox": "^0.27.8" }, @@ -104,6 +109,7 @@ "version": "1.3.0", "resolved": "https://registry.npmjs.org/@jsep-plugin/assignment/-/assignment-1.3.0.tgz", "integrity": "sha512-VVgV+CXrhbMI3aSusQyclHkenWSAm95WaiKrMxRFam3JSUiIaQjoMIw2sEs/OX4XifnqeQUN4DYbJjlA8EfktQ==", + "license": "MIT", "engines": { "node": ">= 10.16.0" }, @@ -115,6 +121,7 @@ "version": "1.0.4", "resolved": "https://registry.npmjs.org/@jsep-plugin/regex/-/regex-1.0.4.tgz", "integrity": "sha512-q7qL4Mgjs1vByCaTnDFcBnV9HS7GVPJX5vyVoCgZHNSC9rjwIlmbXG5sUuorR5ndfHAIlJ8pVStxvjXHbNvtUg==", + "license": "MIT", "engines": { "node": ">= 10.16.0" }, @@ -444,35 +451,36 @@ } }, "node_modules/@redocly/cli": { - "version": "1.34.5", - "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-1.34.5.tgz", - "integrity": "sha512-5IEwxs7SGP5KEXjBKLU8Ffdz9by/KqNSeBk6YUVQaGxMXK//uYlTJIPntgUXbo1KAGG2d2q2XF8y4iFz6qNeiw==", + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-1.34.11.tgz", + "integrity": "sha512-NTFegt2uQ0A4xewDPcTadsZYSlmEUzF7wnvRgmFI8Ftvjpq/coIdr9EQPmCF6wjrh9UBKdz2rMNckxLo/jhViA==", + "license": "MIT", "dependencies": { "@opentelemetry/api": "1.9.0", "@opentelemetry/exporter-trace-otlp-http": "0.53.0", "@opentelemetry/resources": "1.26.0", "@opentelemetry/sdk-trace-node": "1.26.0", "@opentelemetry/semantic-conventions": "1.27.0", - "@redocly/config": "^0.22.0", - "@redocly/openapi-core": "1.34.5", - "@redocly/respect-core": "1.34.5", - "abort-controller": "^3.0.0", - "chokidar": "^3.5.1", - "colorette": "^1.2.0", - "core-js": "^3.32.1", + "@redocly/config": "0.22.0", + "@redocly/openapi-core": "1.34.11", + "@redocly/respect-core": "1.34.11", + "abort-controller": "3.0.0", + "chokidar": "3.5.3", + "colorette": "1.4.0", + "core-js": "3.32.1", "dotenv": "16.4.7", - "form-data": "^4.0.4", - "get-port-please": "^3.0.1", - "glob": "^7.1.6", - "handlebars": "^4.7.6", - "mobx": "^6.0.4", - "pluralize": "^8.0.0", - "react": "^17.0.0 || ^18.2.0 || ^19.0.0", - "react-dom": "^17.0.0 || ^18.2.0 || ^19.0.0", + "form-data": "4.0.4", + "get-port-please": "3.0.1", + "glob": "7.2.3", + "handlebars": "4.7.8", + "mobx": "6.12.3", + "pluralize": "8.0.0", + "react": "^17.0.0 || ^18.2.0 || ^19.2.1", + "react-dom": "^17.0.0 || ^18.2.0 || ^19.2.1", "redoc": "2.5.0", - "semver": "^7.5.2", - "simple-websocket": "^9.0.0", - "styled-components": "^6.0.7", + "semver": "7.7.4", + "simple-websocket": "9.1.0", + "styled-components": "6.3.9", "yargs": "17.0.1" }, "bin": { @@ -484,24 +492,32 @@ "npm": ">=9.5.0" } }, - "node_modules/@redocly/cli/node_modules/lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "dependencies": { - "yallist": "^4.0.0" - }, - "engines": { - "node": ">=10" + "node_modules/@redocly/cli/node_modules/core-js": { + "version": "3.32.1", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.32.1.tgz", + "integrity": "sha512-lqufgNn9NLnESg5mQeYsxQP5w7wrViSj0jr/kv6ECQiByzQkrn1MKvV0L3acttpDqfQrHLwr2KCMgX5b8X+lyQ==", + "hasInstallScript": true, + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/core-js" + } + }, + "node_modules/@redocly/cli/node_modules/mobx": { + "version": "6.12.3", + "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.12.3.tgz", + "integrity": "sha512-c8NKkO4R2lShkSXZ2Ongj1ycjugjzFFo/UswHBnS62y07DMcTc9Rvo03/3nRyszIvwPNljlkd4S828zIBv/piw==", + "license": "MIT", + "funding": { + "type": "opencollective", + "url": "https://opencollective.com/mobx" } }, "node_modules/@redocly/cli/node_modules/semver": { - "version": "7.5.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz", - "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==", - "dependencies": { - "lru-cache": "^6.0.0" - }, + "version": "7.7.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", + "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==", + "license": "ISC", "bin": { "semver": "bin/semver.js" }, @@ -509,30 +525,26 @@ "node": ">=10" } }, - "node_modules/@redocly/cli/node_modules/yallist": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", - "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==" - }, "node_modules/@redocly/config": { - "version": "0.22.2", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.2.tgz", - "integrity": "sha512-roRDai8/zr2S9YfmzUfNhKjOF0NdcOIqF7bhf4MVC5UxpjIysDjyudvlAiVbpPHp3eDRWbdzUgtkK1a7YiDNyQ==", + "version": "0.22.0", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", + "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==", "license": "MIT" }, "node_modules/@redocly/openapi-core": { - "version": "1.34.5", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.5.tgz", - "integrity": "sha512-0EbE8LRbkogtcCXU7liAyC00n9uNG9hJ+eMyHFdUsy9lB/WGqnEBgwjA9q2cyzAVcdTkQqTBBU1XePNnN3OijA==", - "dependencies": { - "@redocly/ajv": "^8.11.2", - "@redocly/config": "^0.22.0", - "colorette": "^1.2.0", - "https-proxy-agent": "^7.0.5", - "js-levenshtein": "^1.1.6", - "js-yaml": "^4.1.0", - "minimatch": "^5.0.1", - "pluralize": "^8.0.0", + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", + "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", + "license": "MIT", + "dependencies": { + "@redocly/ajv": "8.11.2", + "@redocly/config": "0.22.0", + "colorette": "1.4.0", + "https-proxy-agent": "7.0.6", + "js-levenshtein": "1.1.6", + "js-yaml": "4.1.1", + "minimatch": "5.1.9", + "pluralize": "8.0.0", "yaml-ast-parser": "0.0.43" }, "engines": { @@ -541,18 +553,19 @@ } }, "node_modules/@redocly/openapi-core/node_modules/brace-expansion": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", - "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", + "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", "license": "MIT", "dependencies": { "balanced-match": "^1.0.0" } }, "node_modules/@redocly/openapi-core/node_modules/minimatch": { - "version": "5.1.8", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.8.tgz", - "integrity": "sha512-7RN35vit8DeBclkofOVmBY0eDAZZQd1HzmukRdSyz95CRh8FT54eqnbj0krQr3mrHR6sfRyYkyhwBWjoV5uqlQ==", + "version": "5.1.9", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", + "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", + "license": "ISC", "dependencies": { "brace-expansion": "^2.0.1" }, @@ -561,29 +574,30 @@ } }, "node_modules/@redocly/respect-core": { - "version": "1.34.5", - "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-1.34.5.tgz", - "integrity": "sha512-GheC/g/QFztPe9UA9LamooSplQuy9pe0Yr8XGTqkz0ahivLDl7svoy/LSQNn1QH3XGtLKwFYMfTwFR2TAYyh5Q==", + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-1.34.11.tgz", + "integrity": "sha512-0USZA1iRkyCZN/o5ZmgJ9vFVfWe5dE6m2IabF4g7s8EWJErbRFc8LoJ20hfoR75yGUfde+0vTPNOG5T9dlqq1g==", + "license": "MIT", "dependencies": { - "@faker-js/faker": "^7.6.0", + "@faker-js/faker": "7.6.0", "@redocly/ajv": "8.11.2", - "@redocly/openapi-core": "1.34.5", - "better-ajv-errors": "^1.2.0", - "colorette": "^2.0.20", - "concat-stream": "^2.0.0", - "cookie": "^0.7.2", + "@redocly/openapi-core": "1.34.11", + "better-ajv-errors": "1.2.0", + "colorette": "2.0.20", + "concat-stream": "2.0.0", + "cookie": "0.7.2", "dotenv": "16.4.7", - "form-data": "^4.0.4", - "jest-diff": "^29.3.1", - "jest-matcher-utils": "^29.3.1", + "form-data": "4.0.4", + "jest-diff": "29.7.0", + "jest-matcher-utils": "29.7.0", "js-yaml": "4.1.0", - "json-pointer": "^0.6.2", - "jsonpath-plus": "^10.0.6", - "open": "^10.1.0", - "openapi-sampler": "^1.6.1", - "outdent": "^0.8.0", - "set-cookie-parser": "^2.3.5", - "undici": "^6.21.1" + "json-pointer": "0.6.2", + "jsonpath-plus": "10.3.0", + "open": "10.1.0", + "openapi-sampler": "1.7.0", + "outdent": "0.8.0", + "set-cookie-parser": "2.7.1", + "undici": "6.24.1" }, "engines": { "node": ">=18.17.0", @@ -593,12 +607,37 @@ "node_modules/@redocly/respect-core/node_modules/colorette": { "version": "2.0.20", "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz", - "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==" + "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==", + "license": "MIT" + }, + "node_modules/@redocly/respect-core/node_modules/js-yaml": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", + "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "license": "MIT", + "dependencies": { + "argparse": "^2.0.1" + }, + "bin": { + "js-yaml": "bin/js-yaml.js" + } + }, + "node_modules/@redocly/respect-core/node_modules/openapi-sampler": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.0.tgz", + "integrity": "sha512-fWq32F5vqGpgRJYIarC/9Y1wC9tKnRDcCOjsDJ7MIcSv2HsE7kNifcXIZ8FVtNStBUWxYrEk/MKqVF0SwZ5gog==", + "license": "MIT", + "dependencies": { + "@types/json-schema": "^7.0.7", + "fast-xml-parser": "^5.3.4", + "json-pointer": "0.6.2" + } }, "node_modules/@sinclair/typebox": { - "version": "0.27.8", - "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", - "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==" + "version": "0.27.10", + "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.10.tgz", + "integrity": "sha512-MTBk/3jGLNB2tVxv6uLlFh1iu64iYOQ2PbdOSK3NW8JZsmlaOh2q6sdtKowBhfw8QFLmYNzTW4/oK4uATIi6ZA==", + "license": "MIT" }, "node_modules/@types/json-schema": { "version": "7.0.15", @@ -615,9 +654,9 @@ } }, "node_modules/@types/stylis": { - "version": "4.2.5", - "resolved": "https://registry.npmjs.org/@types/stylis/-/stylis-4.2.5.tgz", - "integrity": "sha512-1Xve+NMN7FWjY14vLoY5tL3BVEQ/n42YLwaqJIPYhotZ9uBHt87VceMwWQpzmdEt2TNXIorIFG+YeCUUW7RInw==", + "version": "4.2.7", + "resolved": "https://registry.npmjs.org/@types/stylis/-/stylis-4.2.7.tgz", + "integrity": "sha512-VgDNokpBoKF+wrdvhAAfS55OMQpL6QRglwTwNC3kIgBrzZxA4WsFj+2eLfEA/uMUDzBcEhYmjSbwQakn/i3ajA==", "license": "MIT" }, "node_modules/@types/trusted-types": { @@ -656,6 +695,7 @@ "version": "8.18.0", "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz", "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==", + "license": "MIT", "peer": true, "dependencies": { "fast-deep-equal": "^3.1.3", @@ -693,6 +733,7 @@ "version": "3.1.3", "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", + "license": "ISC", "dependencies": { "normalize-path": "^3.0.0", "picomatch": "^2.0.4" @@ -722,26 +763,11 @@ "integrity": "sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=", "dev": true }, - "node_modules/async-function": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz", - "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==", - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/async-generator-function": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/async-generator-function/-/async-generator-function-1.0.0.tgz", - "integrity": "sha512-+NAXNqgCrB95ya4Sr66i1CL2hqLVckAk7xwRYWdcm39/ELQ6YNn1aw5r0bdQtqNZgQpEWzc5yc/igXc7aL5SLA==", - "engines": { - "node": ">= 0.4" - } - }, "node_modules/asynckit": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", - "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==" + "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", + "license": "MIT" }, "node_modules/balanced-match": { "version": "1.0.2", @@ -752,6 +778,7 @@ "version": "1.2.0", "resolved": "https://registry.npmjs.org/better-ajv-errors/-/better-ajv-errors-1.2.0.tgz", "integrity": "sha512-UW+IsFycygIo7bclP9h5ugkNH8EjCSgqyFB/yQ4Hqqa1OEYDtb0uFIkYE0b6+CjkgJYVM5UKI/pJPxjYe9EZlA==", + "license": "Apache-2.0", "dependencies": { "@babel/code-frame": "^7.16.0", "@humanwhocodes/momoa": "^2.0.2", @@ -770,6 +797,7 @@ "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", "dependencies": { "color-convert": "^2.0.1" }, @@ -784,6 +812,7 @@ "version": "4.1.2", "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -799,6 +828,7 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -809,12 +839,14 @@ "node_modules/better-ajv-errors/node_modules/color-name": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" }, "node_modules/better-ajv-errors/node_modules/has-flag": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", "engines": { "node": ">=8" } @@ -823,6 +855,7 @@ "version": "7.2.0", "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -834,6 +867,7 @@ "version": "2.3.0", "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", + "license": "MIT", "engines": { "node": ">=8" }, @@ -855,6 +889,7 @@ "version": "3.0.3", "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "license": "MIT", "dependencies": { "fill-range": "^7.1.1" }, @@ -865,12 +900,14 @@ "node_modules/buffer-from": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", - "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==" + "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", + "license": "MIT" }, "node_modules/bundle-name": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz", "integrity": "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==", + "license": "MIT", "dependencies": { "run-applescript": "^7.0.0" }, @@ -924,9 +961,16 @@ } }, "node_modules/chokidar": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz", - "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==", + "version": "3.5.3", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz", + "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==", + "funding": [ + { + "type": "individual", + "url": "https://paulmillr.com/funding/" + } + ], + "license": "MIT", "dependencies": { "anymatch": "~3.1.2", "braces": "~3.0.2", @@ -939,9 +983,6 @@ "engines": { "node": ">= 8.10.0" }, - "funding": { - "url": "https://paulmillr.com/funding/" - }, "optionalDependencies": { "fsevents": "~2.3.2" } @@ -997,6 +1038,7 @@ "version": "1.0.8", "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", + "license": "MIT", "dependencies": { "delayed-stream": "~1.0.0" }, @@ -1016,6 +1058,7 @@ "engines": [ "node >= 6.0" ], + "license": "MIT", "dependencies": { "buffer-from": "^1.0.0", "inherits": "^2.0.3", @@ -1023,23 +1066,11 @@ "typedarray": "^0.0.6" } }, - "node_modules/concat-stream/node_modules/readable-stream": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", - "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "dependencies": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - }, - "engines": { - "node": ">= 6" - } - }, "node_modules/cookie": { "version": "0.7.2", "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==", + "license": "MIT", "engines": { "node": ">= 0.6" } @@ -1049,6 +1080,7 @@ "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.48.0.tgz", "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==", "hasInstallScript": true, + "peer": true, "funding": { "type": "opencollective", "url": "https://opencollective.com/core-js" @@ -1075,9 +1107,9 @@ } }, "node_modules/csstype": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.3.tgz", - "integrity": "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==", + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==", "license": "MIT" }, "node_modules/debug": { @@ -1114,6 +1146,7 @@ "version": "5.5.0", "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz", "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==", + "license": "MIT", "dependencies": { "bundle-name": "^4.1.0", "default-browser-id": "^5.0.0" @@ -1129,6 +1162,7 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==", + "license": "MIT", "engines": { "node": ">=18" }, @@ -1140,6 +1174,7 @@ "version": "3.0.0", "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz", "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==", + "license": "MIT", "engines": { "node": ">=12" }, @@ -1151,6 +1186,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", + "license": "MIT", "engines": { "node": ">=0.4.0" } @@ -1169,6 +1205,7 @@ "version": "29.6.3", "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==", + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -1188,6 +1225,7 @@ "version": "16.4.7", "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.4.7.tgz", "integrity": "sha512-47qPchRCykZC03FhkYAhrvwU4xDBFIj1QPqaarj6mdM/hgUzfPHcpkHJOn3mJAufFeeAxAzeGsr5X0M4k6fLZQ==", + "license": "BSD-2-Clause", "engines": { "node": ">=12" }, @@ -1199,6 +1237,7 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", + "license": "MIT", "dependencies": { "call-bind-apply-helpers": "^1.0.1", "es-errors": "^1.3.0", @@ -1218,6 +1257,7 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", + "license": "MIT", "engines": { "node": ">= 0.4" } @@ -1226,6 +1266,7 @@ "version": "1.3.0", "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "license": "MIT", "engines": { "node": ">= 0.4" } @@ -1234,6 +1275,7 @@ "version": "1.1.1", "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "license": "MIT", "dependencies": { "es-errors": "^1.3.0" }, @@ -1245,6 +1287,7 @@ "version": "2.1.0", "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", + "license": "MIT", "dependencies": { "es-errors": "^1.3.0", "get-intrinsic": "^1.2.6", @@ -1319,36 +1362,39 @@ "url": "https://opencollective.com/fastify" } ], + "license": "BSD-3-Clause", "peer": true }, "node_modules/fast-xml-builder": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.0.tgz", - "integrity": "sha512-7mtITW/we2/wTUZqMyBOR2F8xP4CRxMiSEcQxPIqdRWdO2L/HZSOlzoNyghmyDwNB8BDxePooV1ZTJpkOUhdRg==", + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz", + "integrity": "sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], + "license": "MIT", "dependencies": { - "path-expression-matcher": "^1.1.2" + "path-expression-matcher": "^1.1.3" } }, "node_modules/fast-xml-parser": { - "version": "5.5.1", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.1.tgz", - "integrity": "sha512-JTpMz8P5mDoNYzXTmTT/xzWjFiCWi0U+UQTJtrFH9muXsr2RqtXZPbnCW5h2mKsOd4u3XcPWCvDSrnaBPlUcMQ==", + "version": "5.5.9", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.9.tgz", + "integrity": "sha512-jldvxr1MC6rtiZKgrFnDSvT8xuH+eJqxqOBThUVjYrxssYTo1avZLGql5l0a0BAERR01CadYzZ83kVEkbyDg+g==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], + "license": "MIT", "dependencies": { - "fast-xml-builder": "^1.1.0", - "path-expression-matcher": "^1.1.2", - "strnum": "^2.1.2" + "fast-xml-builder": "^1.1.4", + "path-expression-matcher": "^1.2.0", + "strnum": "^2.2.2" }, "bin": { "fxparser": "src/cli/cli.js" @@ -1358,6 +1404,7 @@ "version": "7.1.1", "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "license": "MIT", "dependencies": { "to-regex-range": "^5.0.1" }, @@ -1372,9 +1419,10 @@ "license": "MIT" }, "node_modules/form-data": { - "version": "4.0.5", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", - "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz", + "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==", + "license": "MIT", "dependencies": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", @@ -1396,6 +1444,7 @@ "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", "hasInstallScript": true, + "license": "MIT", "optional": true, "os": [ "darwin" @@ -1412,14 +1461,6 @@ "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/generator-function": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz", - "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==", - "engines": { - "node": ">= 0.4" - } - }, "node_modules/get-caller-file": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", @@ -1430,18 +1471,16 @@ } }, "node_modules/get-intrinsic": { - "version": "1.3.1", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.1.tgz", - "integrity": "sha512-fk1ZVEeOX9hVZ6QzoBNEC55+Ucqg4sTVwrVuigZhuRPESVFpMyXnd3sbXvPOwp7Y9riVyANiqhEuRF0G1aVSeQ==", + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", + "license": "MIT", "dependencies": { - "async-function": "^1.0.0", - "async-generator-function": "^1.0.0", "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", - "generator-function": "^2.0.0", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", @@ -1456,14 +1495,16 @@ } }, "node_modules/get-port-please": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.2.0.tgz", - "integrity": "sha512-I9QVvBw5U/hw3RmWpYKRumUeaDgxTPd401x364rLmWBJcOQ753eov1eTgzDqRG9bqFIfDc7gfzcQEWrUri3o1A==" + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.0.1.tgz", + "integrity": "sha512-R5pcVO8Z1+pVDu8Ml3xaJCEkBiiy1VQN9za0YqH8GIi1nIqD4IzQhzY6dDzMRtdS1lyiGlucRzm8IN8wtLIXng==", + "license": "MIT" }, "node_modules/get-proto": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", + "license": "MIT", "dependencies": { "dunder-proto": "^1.0.1", "es-object-atoms": "^1.0.0" @@ -1495,6 +1536,7 @@ "version": "5.1.2", "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "license": "ISC", "dependencies": { "is-glob": "^4.0.1" }, @@ -1506,6 +1548,7 @@ "version": "1.2.0", "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -1552,6 +1595,7 @@ "version": "1.1.0", "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -1563,6 +1607,7 @@ "version": "1.0.2", "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", + "license": "MIT", "dependencies": { "has-symbols": "^1.0.3" }, @@ -1627,6 +1672,7 @@ "version": "2.1.0", "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", + "license": "MIT", "dependencies": { "binary-extensions": "^2.0.0" }, @@ -1653,6 +1699,7 @@ "version": "3.0.0", "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz", "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==", + "license": "MIT", "bin": { "is-docker": "cli.js" }, @@ -1667,6 +1714,7 @@ "version": "2.1.1", "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1684,6 +1732,7 @@ "version": "4.0.3", "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "license": "MIT", "dependencies": { "is-extglob": "^2.1.1" }, @@ -1695,6 +1744,7 @@ "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz", "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==", + "license": "MIT", "dependencies": { "is-docker": "^3.0.0" }, @@ -1712,6 +1762,7 @@ "version": "7.0.0", "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "license": "MIT", "engines": { "node": ">=0.12.0" } @@ -1720,6 +1771,7 @@ "version": "3.1.1", "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz", "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==", + "license": "MIT", "dependencies": { "is-inside-container": "^1.0.0" }, @@ -1734,6 +1786,7 @@ "version": "29.7.0", "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "diff-sequences": "^29.6.3", @@ -1748,6 +1801,7 @@ "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", "dependencies": { "color-convert": "^2.0.1" }, @@ -1762,6 +1816,7 @@ "version": "4.1.2", "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -1777,6 +1832,7 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -1787,12 +1843,14 @@ "node_modules/jest-diff/node_modules/color-name": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" }, "node_modules/jest-diff/node_modules/has-flag": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", "engines": { "node": ">=8" } @@ -1801,6 +1859,7 @@ "version": "7.2.0", "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -1812,6 +1871,7 @@ "version": "29.6.3", "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==", + "license": "MIT", "engines": { "node": "^14.15.0 || ^16.10.0 || >=18.0.0" } @@ -1820,6 +1880,7 @@ "version": "29.7.0", "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", + "license": "MIT", "dependencies": { "chalk": "^4.0.0", "jest-diff": "^29.7.0", @@ -1834,6 +1895,7 @@ "version": "4.3.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", "dependencies": { "color-convert": "^2.0.1" }, @@ -1848,6 +1910,7 @@ "version": "4.1.2", "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -1863,6 +1926,7 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -1873,12 +1937,14 @@ "node_modules/jest-matcher-utils/node_modules/color-name": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" }, "node_modules/jest-matcher-utils/node_modules/has-flag": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", "engines": { "node": ">=8" } @@ -1887,6 +1953,7 @@ "version": "7.2.0", "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", "dependencies": { "has-flag": "^4.0.0" }, @@ -1910,9 +1977,9 @@ "license": "MIT" }, "node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", "license": "MIT", "dependencies": { "argparse": "^2.0.1" @@ -1925,6 +1992,7 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/jsep/-/jsep-1.4.0.tgz", "integrity": "sha512-B7qPcEVE3NVkmSJbaYxvv4cHkVW7DQsZz13pUMrfS8z8Q/BuShN+gcTXrUlPiGqM2/t/EEaI030bpxMqY8gMlw==", + "license": "MIT", "engines": { "node": ">= 10.16.0" } @@ -1954,6 +2022,7 @@ "version": "10.3.0", "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-10.3.0.tgz", "integrity": "sha512-8TNmfeTCk2Le33A3vRRwtuworG/L5RrgMvdjhKZxvyShO+mBu2fP50OWUjRLNtvw344DdDarFh9buFAZs5ujeA==", + "license": "MIT", "dependencies": { "@jsep-plugin/assignment": "^1.3.0", "@jsep-plugin/regex": "^1.0.4", @@ -1971,6 +2040,7 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz", "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==", + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1979,6 +2049,7 @@ "version": "3.1.0", "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==", + "license": "MIT", "engines": { "node": ">=6" } @@ -2059,14 +2130,25 @@ "version": "1.1.0", "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", + "license": "MIT", "engines": { "node": ">= 0.4" } }, + "node_modules/mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", + "license": "MIT", + "engines": { + "node": ">= 0.6" + } + }, "node_modules/mime-types": { "version": "2.1.35", "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", + "license": "MIT", "dependencies": { "mime-db": "1.52.0" }, @@ -2074,14 +2156,6 @@ "node": ">= 0.6" } }, - "node_modules/mime-types/node_modules/mime-db": { - "version": "1.52.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", - "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", - "engines": { - "node": ">= 0.6" - } - }, "node_modules/minimatch": { "version": "3.1.4", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.4.tgz", @@ -2117,6 +2191,7 @@ "version": "6.15.0", "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.0.tgz", "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==", + "peer": true, "funding": { "type": "opencollective", "url": "https://opencollective.com/mobx" @@ -2268,6 +2343,7 @@ "version": "3.0.0", "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -2366,14 +2442,15 @@ } }, "node_modules/open": { - "version": "10.2.0", - "resolved": "https://registry.npmjs.org/open/-/open-10.2.0.tgz", - "integrity": "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==", + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/open/-/open-10.1.0.tgz", + "integrity": "sha512-mnkeQ1qP5Ue2wd+aivTD3NHd/lZ96Lu0jgf0pwktLPtx6cTZiH7tyeGRRHs0zX0rbrahXPnXlUnbeXyaBBuIaw==", + "license": "MIT", "dependencies": { "default-browser": "^5.2.1", "define-lazy-prop": "^3.0.0", "is-inside-container": "^1.0.0", - "wsl-utils": "^0.1.0" + "is-wsl": "^3.1.0" }, "engines": { "node": ">=18" @@ -2423,7 +2500,8 @@ "node_modules/outdent": { "version": "0.8.0", "resolved": "https://registry.npmjs.org/outdent/-/outdent-0.8.0.tgz", - "integrity": "sha512-KiOAIsdpUTcAXuykya5fnVVT+/5uS0Q1mrkRHcF89tpieSmY33O/tmc54CqwA+bfhbtEfZUNLHaPUiB9X3jt1A==" + "integrity": "sha512-KiOAIsdpUTcAXuykya5fnVVT+/5uS0Q1mrkRHcF89tpieSmY33O/tmc54CqwA+bfhbtEfZUNLHaPUiB9X3jt1A==", + "license": "MIT" }, "node_modules/path-browserify": { "version": "1.0.1", @@ -2432,15 +2510,16 @@ "license": "MIT" }, "node_modules/path-expression-matcher": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.1.2.tgz", - "integrity": "sha512-LXWqJmcpp2BKOEmgt4CyuESFmBfPuhJlAHKJsFzuJU6CxErWk75BrO+Ni77M9OxHN6dCYKM4vj+21Z6cOL96YQ==", + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz", + "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], + "license": "MIT", "engines": { "node": ">=14.0.0" } @@ -2472,9 +2551,10 @@ "license": "ISC" }, "node_modules/picomatch": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", - "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "license": "MIT", "engines": { "node": ">=8.6" }, @@ -2541,6 +2621,7 @@ "version": "29.7.0", "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", + "license": "MIT", "dependencies": { "@jest/schemas": "^29.6.3", "ansi-styles": "^5.0.0", @@ -2554,6 +2635,7 @@ "version": "5.2.0", "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", + "license": "MIT", "engines": { "node": ">=10" }, @@ -2659,7 +2741,8 @@ "node_modules/react-is": { "version": "18.3.1", "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", - "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==" + "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==", + "license": "MIT" }, "node_modules/react-tabs": { "version": "6.1.0", @@ -2703,6 +2786,20 @@ "npm-normalize-package-bin": "^1.0.0" } }, + "node_modules/readable-stream": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", + "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", + "license": "MIT", + "dependencies": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + }, + "engines": { + "node": ">= 6" + } + }, "node_modules/readdir-scoped-modules": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/readdir-scoped-modules/-/readdir-scoped-modules-1.1.0.tgz", @@ -2720,6 +2817,7 @@ "version": "3.6.0", "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", + "license": "MIT", "dependencies": { "picomatch": "^2.2.1" }, @@ -2818,6 +2916,7 @@ "version": "7.1.0", "resolved": "https://registry.npmjs.org/run-applescript/-/run-applescript-7.1.0.tgz", "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==", + "license": "MIT", "engines": { "node": ">=18" }, @@ -2859,9 +2958,10 @@ } }, "node_modules/set-cookie-parser": { - "version": "2.7.2", - "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", - "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==" + "version": "2.7.1", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.1.tgz", + "integrity": "sha512-IOc8uWeOZgnb3ptbCURJWNjWUPcO3ZnTTdzsurqERrP6nPyv+paC55vJM0LpOlT2ne+Ix+9+CRG1MNLlyZ4GjQ==", + "license": "MIT" }, "node_modules/shallowequal": { "version": "1.1.0", @@ -2949,19 +3049,6 @@ "ws": "^7.4.2" } }, - "node_modules/simple-websocket/node_modules/readable-stream": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", - "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "dependencies": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - }, - "engines": { - "node": ">= 6" - } - }, "node_modules/slide": { "version": "1.1.6", "resolved": "https://registry.npmjs.org/slide/-/slide-1.1.6.tgz", @@ -3097,31 +3184,32 @@ } }, "node_modules/strnum": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.0.tgz", - "integrity": "sha512-Y7Bj8XyJxnPAORMZj/xltsfo55uOiyHcU2tnAVzHUnSJR/KsEX+9RoDeXEnsXtl/CX4fAcrt64gZ13aGaWPeBg==", + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.2.tgz", + "integrity": "sha512-DnR90I+jtXNSTXWdwrEy9FakW7UX+qUZg28gj5fk2vxxl7uS/3bpI4fjFYVmdK9etptYBPNkpahuQnEwhwECqA==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } - ] + ], + "license": "MIT" }, "node_modules/styled-components": { - "version": "6.1.19", - "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.1.19.tgz", - "integrity": "sha512-1v/e3Dl1BknC37cXMhwGomhO8AkYmN41CqyX9xhUDxry1ns3BFQy2lLDRQXJRdVVWB9OHemv/53xaStimvWyuA==", + "version": "6.3.9", + "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.3.9.tgz", + "integrity": "sha512-J72R4ltw0UBVUlEjTzI0gg2STOqlI9JBhQOL4Dxt7aJOnnSesy0qJDn4PYfMCafk9cWOaVg129Pesl5o+DIh0Q==", "license": "MIT", "dependencies": { - "@emotion/is-prop-valid": "1.2.2", - "@emotion/unitless": "0.8.1", - "@types/stylis": "4.2.5", + "@emotion/is-prop-valid": "1.4.0", + "@emotion/unitless": "0.10.0", + "@types/stylis": "4.2.7", "css-to-react-native": "3.2.0", - "csstype": "3.1.3", + "csstype": "3.2.3", "postcss": "8.4.49", "shallowequal": "1.1.0", - "stylis": "4.3.2", - "tslib": "2.6.2" + "stylis": "4.3.6", + "tslib": "2.8.1" }, "engines": { "node": ">= 16" @@ -3133,12 +3221,17 @@ "peerDependencies": { "react": ">= 16.8.0", "react-dom": ">= 16.8.0" + }, + "peerDependenciesMeta": { + "react-dom": { + "optional": true + } } }, "node_modules/stylis": { - "version": "4.3.2", - "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.2.tgz", - "integrity": "sha512-bhtUjWd/z6ltJiQwg0dUfxEJ+W+jdqQd8TbWLWyeIJHlnsqmGLRFFd8e5mA0AZi/zx90smXRlN66YMTcaSFifg==", + "version": "4.3.6", + "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.6.tgz", + "integrity": "sha512-yQ3rwFWRfwNUY7H5vpU0wfdkNSnvnJinhF9830Swlaxl03zsOjCfmX0ugac+3LtK0lYSgwL/KXc8oYL3mG4YFQ==", "license": "MIT" }, "node_modules/supports-color": { @@ -3196,6 +3289,7 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "license": "MIT", "dependencies": { "is-number": "^7.0.0" }, @@ -3219,15 +3313,16 @@ } }, "node_modules/tslib": { - "version": "2.6.2", - "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.6.2.tgz", - "integrity": "sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==", + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", "license": "0BSD" }, "node_modules/typedarray": { "version": "0.0.6", "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", - "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==" + "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==", + "license": "MIT" }, "node_modules/uglify-js": { "version": "3.19.3", @@ -3245,6 +3340,7 @@ "version": "6.24.1", "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.1.tgz", "integrity": "sha512-sC+b0tB1whOCzbtlx20fx3WgCXwkW627p4EA9uM+/tNNPkSS+eSEld6pAs9nDv7WbY1UUljBMYPtu9BCOrCWKA==", + "license": "MIT", "engines": { "node": ">=18.17" } @@ -3391,20 +3487,6 @@ } } }, - "node_modules/wsl-utils": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.1.0.tgz", - "integrity": "sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==", - "dependencies": { - "is-wsl": "^3.1.0" - }, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/y18n": { "version": "5.0.8", "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", @@ -3415,9 +3497,9 @@ } }, "node_modules/yaml": { - "version": "1.10.2", - "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz", - "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==", + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==", "license": "ISC", "engines": { "node": ">= 6" @@ -3459,11 +3541,11 @@ }, "dependencies": { "@babel/code-frame": { - "version": "7.27.1", - "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.27.1.tgz", - "integrity": "sha512-cjQ7ZlQ0Mv3b47hABuTevyTuYN4i+loJKGeV9flcCgIK37cCXRh+L1bd3iBHlynerhQ7BhCkn2BPbQUL+rGqFg==", + "version": "7.29.0", + "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", + "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==", "requires": { - "@babel/helper-validator-identifier": "^7.27.1", + "@babel/helper-validator-identifier": "^7.28.5", "js-tokens": "^4.0.0", "picocolors": "^1.1.1" } @@ -3479,22 +3561,22 @@ "integrity": "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==" }, "@emotion/is-prop-valid": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-1.2.2.tgz", - "integrity": "sha512-uNsoYd37AFmaCdXlg6EYD1KaPOaRWRByMCYzbKUX4+hhMfrxdVSelShywL4JVaAeM/eHUOSprYBQls+/neX3pw==", + "version": "1.4.0", + "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-1.4.0.tgz", + "integrity": "sha512-QgD4fyscGcbbKwJmqNvUMSE02OsHUa+lAWKdEUIJKgqe5IwRSKd7+KhibEWdaKwgjLj0DRSHA9biAIqGBk05lw==", "requires": { - "@emotion/memoize": "^0.8.1" + "@emotion/memoize": "^0.9.0" } }, "@emotion/memoize": { - "version": "0.8.1", - "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.8.1.tgz", - "integrity": "sha512-W2P2c/VRW1/1tLox0mVUalvnWXxavmv/Oum2aPsRcoDJuob75FC3Y8FbpfLwUegRcxINtGUMPq0tFCvYNTBXNA==" + "version": "0.9.0", + "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.9.0.tgz", + "integrity": "sha512-30FAj7/EoJ5mwVPOWhAyCX+FPfMDrVecJAM+Iw9NRoSl4BBAQeqj4cApHHUXOVvIPgLVDsCFoz/hGD+5QQD1GQ==" }, "@emotion/unitless": { - "version": "0.8.1", - "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.8.1.tgz", - "integrity": "sha512-KOEGMu6dmJZtpadb476IsZBclKvILjopjUii3V+7MnXIQCYh8W3NgNcgwo21n9LXZX6EDIKvqfjYxXebDwxKmQ==" + "version": "0.10.0", + "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.10.0.tgz", + "integrity": "sha512-dFoMUuQA20zvtVTuxZww6OHoJYgrzfKM1t52mVySDJnMSEa08ruEvdYQbhvyu6soU+NeLVd3yKfTfT0NeV6qGg==" }, "@exodus/schemasafe": { "version": "1.3.0", @@ -3738,94 +3820,88 @@ } }, "@redocly/cli": { - "version": "1.34.5", - "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-1.34.5.tgz", - "integrity": "sha512-5IEwxs7SGP5KEXjBKLU8Ffdz9by/KqNSeBk6YUVQaGxMXK//uYlTJIPntgUXbo1KAGG2d2q2XF8y4iFz6qNeiw==", + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-1.34.11.tgz", + "integrity": "sha512-NTFegt2uQ0A4xewDPcTadsZYSlmEUzF7wnvRgmFI8Ftvjpq/coIdr9EQPmCF6wjrh9UBKdz2rMNckxLo/jhViA==", "requires": { "@opentelemetry/api": "1.9.0", "@opentelemetry/exporter-trace-otlp-http": "0.53.0", "@opentelemetry/resources": "1.26.0", "@opentelemetry/sdk-trace-node": "1.26.0", "@opentelemetry/semantic-conventions": "1.27.0", - "@redocly/config": "^0.22.0", - "@redocly/openapi-core": "1.34.5", - "@redocly/respect-core": "1.34.5", - "abort-controller": "^3.0.0", - "chokidar": "^3.5.1", - "colorette": "^1.2.0", - "core-js": "^3.32.1", + "@redocly/config": "0.22.0", + "@redocly/openapi-core": "1.34.11", + "@redocly/respect-core": "1.34.11", + "abort-controller": "3.0.0", + "chokidar": "3.5.3", + "colorette": "1.4.0", + "core-js": "3.32.1", "dotenv": "16.4.7", - "form-data": "^4.0.4", - "get-port-please": "^3.0.1", - "glob": "^7.1.6", - "handlebars": "^4.7.6", - "mobx": "^6.0.4", - "pluralize": "^8.0.0", - "react": "^17.0.0 || ^18.2.0 || ^19.0.0", - "react-dom": "^17.0.0 || ^18.2.0 || ^19.0.0", + "form-data": "4.0.4", + "get-port-please": "3.0.1", + "glob": "7.2.3", + "handlebars": "4.7.8", + "mobx": "6.12.3", + "pluralize": "8.0.0", + "react": "^17.0.0 || ^18.2.0 || ^19.2.1", + "react-dom": "^17.0.0 || ^18.2.0 || ^19.2.1", "redoc": "2.5.0", - "semver": "^7.5.2", - "simple-websocket": "^9.0.0", - "styled-components": "^6.0.7", + "semver": "7.7.4", + "simple-websocket": "9.1.0", + "styled-components": "6.3.9", "yargs": "17.0.1" }, "dependencies": { - "lru-cache": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-6.0.0.tgz", - "integrity": "sha512-Jo6dJ04CmSjuznwJSS3pUeWmd/H0ffTlkXXgwZi+eq1UCmqQwCh+eLsYOYCwY991i2Fah4h1BEMCx4qThGbsiA==", - "requires": { - "yallist": "^4.0.0" - } + "core-js": { + "version": "3.32.1", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.32.1.tgz", + "integrity": "sha512-lqufgNn9NLnESg5mQeYsxQP5w7wrViSj0jr/kv6ECQiByzQkrn1MKvV0L3acttpDqfQrHLwr2KCMgX5b8X+lyQ==" }, - "semver": { - "version": "7.5.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.5.4.tgz", - "integrity": "sha512-1bCSESV6Pv+i21Hvpxp3Dx+pSD8lIPt8uVjRrxAUt/nbswYc+tK6Y2btiULjd4+fnq15PX+nqQDC7Oft7WkwcA==", - "requires": { - "lru-cache": "^6.0.0" - } + "mobx": { + "version": "6.12.3", + "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.12.3.tgz", + "integrity": "sha512-c8NKkO4R2lShkSXZ2Ongj1ycjugjzFFo/UswHBnS62y07DMcTc9Rvo03/3nRyszIvwPNljlkd4S828zIBv/piw==" }, - "yallist": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/yallist/-/yallist-4.0.0.tgz", - "integrity": "sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A==" + "semver": { + "version": "7.7.4", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", + "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==" } } }, "@redocly/config": { - "version": "0.22.2", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.2.tgz", - "integrity": "sha512-roRDai8/zr2S9YfmzUfNhKjOF0NdcOIqF7bhf4MVC5UxpjIysDjyudvlAiVbpPHp3eDRWbdzUgtkK1a7YiDNyQ==" + "version": "0.22.0", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", + "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==" }, "@redocly/openapi-core": { - "version": "1.34.5", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.5.tgz", - "integrity": "sha512-0EbE8LRbkogtcCXU7liAyC00n9uNG9hJ+eMyHFdUsy9lB/WGqnEBgwjA9q2cyzAVcdTkQqTBBU1XePNnN3OijA==", + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", + "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", "requires": { - "@redocly/ajv": "^8.11.2", - "@redocly/config": "^0.22.0", - "colorette": "^1.2.0", - "https-proxy-agent": "^7.0.5", - "js-levenshtein": "^1.1.6", - "js-yaml": "^4.1.0", - "minimatch": "^5.0.1", - "pluralize": "^8.0.0", + "@redocly/ajv": "8.11.2", + "@redocly/config": "0.22.0", + "colorette": "1.4.0", + "https-proxy-agent": "7.0.6", + "js-levenshtein": "1.1.6", + "js-yaml": "4.1.1", + "minimatch": "5.1.9", + "pluralize": "8.0.0", "yaml-ast-parser": "0.0.43" }, "dependencies": { "brace-expansion": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.2.tgz", - "integrity": "sha512-Jt0vHyM+jmUBqojB7E1NIYadt0vI0Qxjxd2TErW94wDz+E2LAm5vKMXXwg6ZZBTHPuUlDgQHKXvjGBdfcF1ZDQ==", + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", + "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", "requires": { "balanced-match": "^1.0.0" } }, "minimatch": { - "version": "5.1.8", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.8.tgz", - "integrity": "sha512-7RN35vit8DeBclkofOVmBY0eDAZZQd1HzmukRdSyz95CRh8FT54eqnbj0krQr3mrHR6sfRyYkyhwBWjoV5uqlQ==", + "version": "5.1.9", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", + "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", "requires": { "brace-expansion": "^2.0.1" } @@ -3833,42 +3909,60 @@ } }, "@redocly/respect-core": { - "version": "1.34.5", - "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-1.34.5.tgz", - "integrity": "sha512-GheC/g/QFztPe9UA9LamooSplQuy9pe0Yr8XGTqkz0ahivLDl7svoy/LSQNn1QH3XGtLKwFYMfTwFR2TAYyh5Q==", + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-1.34.11.tgz", + "integrity": "sha512-0USZA1iRkyCZN/o5ZmgJ9vFVfWe5dE6m2IabF4g7s8EWJErbRFc8LoJ20hfoR75yGUfde+0vTPNOG5T9dlqq1g==", "requires": { - "@faker-js/faker": "^7.6.0", + "@faker-js/faker": "7.6.0", "@redocly/ajv": "8.11.2", - "@redocly/openapi-core": "1.34.5", - "better-ajv-errors": "^1.2.0", - "colorette": "^2.0.20", - "concat-stream": "^2.0.0", - "cookie": "^0.7.2", + "@redocly/openapi-core": "1.34.11", + "better-ajv-errors": "1.2.0", + "colorette": "2.0.20", + "concat-stream": "2.0.0", + "cookie": "0.7.2", "dotenv": "16.4.7", - "form-data": "^4.0.4", - "jest-diff": "^29.3.1", - "jest-matcher-utils": "^29.3.1", + "form-data": "4.0.4", + "jest-diff": "29.7.0", + "jest-matcher-utils": "29.7.0", "js-yaml": "4.1.0", - "json-pointer": "^0.6.2", - "jsonpath-plus": "^10.0.6", - "open": "^10.1.0", - "openapi-sampler": "^1.6.1", - "outdent": "^0.8.0", - "set-cookie-parser": "^2.3.5", - "undici": "^6.21.1" + "json-pointer": "0.6.2", + "jsonpath-plus": "10.3.0", + "open": "10.1.0", + "openapi-sampler": "1.7.0", + "outdent": "0.8.0", + "set-cookie-parser": "2.7.1", + "undici": "6.24.1" }, "dependencies": { "colorette": { "version": "2.0.20", "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz", "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==" + }, + "js-yaml": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", + "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "requires": { + "argparse": "^2.0.1" + } + }, + "openapi-sampler": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.0.tgz", + "integrity": "sha512-fWq32F5vqGpgRJYIarC/9Y1wC9tKnRDcCOjsDJ7MIcSv2HsE7kNifcXIZ8FVtNStBUWxYrEk/MKqVF0SwZ5gog==", + "requires": { + "@types/json-schema": "^7.0.7", + "fast-xml-parser": "^5.3.4", + "json-pointer": "0.6.2" + } } } }, "@sinclair/typebox": { - "version": "0.27.8", - "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.8.tgz", - "integrity": "sha512-+Fj43pSMwJs4KRrH/938Uf+uAELIgVBmQzg/q1YG10djyfA3TnrU8N8XzqCh/okZdszqBQTZf96idMfE5lnwTA==" + "version": "0.27.10", + "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.10.tgz", + "integrity": "sha512-MTBk/3jGLNB2tVxv6uLlFh1iu64iYOQ2PbdOSK3NW8JZsmlaOh2q6sdtKowBhfw8QFLmYNzTW4/oK4uATIi6ZA==" }, "@types/json-schema": { "version": "7.0.15", @@ -3884,9 +3978,9 @@ } }, "@types/stylis": { - "version": "4.2.5", - "resolved": "https://registry.npmjs.org/@types/stylis/-/stylis-4.2.5.tgz", - "integrity": "sha512-1Xve+NMN7FWjY14vLoY5tL3BVEQ/n42YLwaqJIPYhotZ9uBHt87VceMwWQpzmdEt2TNXIorIFG+YeCUUW7RInw==" + "version": "4.2.7", + "resolved": "https://registry.npmjs.org/@types/stylis/-/stylis-4.2.7.tgz", + "integrity": "sha512-VgDNokpBoKF+wrdvhAAfS55OMQpL6QRglwTwNC3kIgBrzZxA4WsFj+2eLfEA/uMUDzBcEhYmjSbwQakn/i3ajA==" }, "@types/trusted-types": { "version": "2.0.7", @@ -3965,16 +4059,6 @@ "integrity": "sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=", "dev": true }, - "async-function": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/async-function/-/async-function-1.0.0.tgz", - "integrity": "sha512-hsU18Ae8CDTR6Kgu9DYf0EbCr/a5iGL0rytQDobUcdpYOKokk8LEjVphnXkDkgpi0wYVsqrXuP0bZxJaTqdgoA==" - }, - "async-generator-function": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/async-generator-function/-/async-generator-function-1.0.0.tgz", - "integrity": "sha512-+NAXNqgCrB95ya4Sr66i1CL2hqLVckAk7xwRYWdcm39/ELQ6YNn1aw5r0bdQtqNZgQpEWzc5yc/igXc7aL5SLA==" - }, "asynckit": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", @@ -4108,9 +4192,9 @@ } }, "chokidar": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.6.0.tgz", - "integrity": "sha512-7VT13fmjotKpGipCW9JEQAusEPE+Ei8nl6/g4FBAmIm0GOOLMua9NDDo/DWp0ZAxCr3cPq5ZpBqmPAQgDda2Pw==", + "version": "3.5.3", + "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz", + "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==", "requires": { "anymatch": "~3.1.2", "braces": "~3.0.2", @@ -4184,18 +4268,6 @@ "inherits": "^2.0.3", "readable-stream": "^3.0.2", "typedarray": "^0.0.6" - }, - "dependencies": { - "readable-stream": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", - "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "requires": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - } - } } }, "cookie": { @@ -4206,7 +4278,8 @@ "core-js": { "version": "3.48.0", "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.48.0.tgz", - "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==" + "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==", + "peer": true }, "css-color-keywords": { "version": "1.0.0", @@ -4224,9 +4297,9 @@ } }, "csstype": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.1.3.tgz", - "integrity": "sha512-M1uQkMl8rQK/szD0LNhtqxIPLpimGm8sOBwU7lLnCpSbTyY3yeU1Vc7l4KT5zT4s/yOxHH5O7tIuuLOCnLADRw==" + "version": "3.2.3", + "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", + "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==" }, "debug": { "version": "4.4.3", @@ -4386,21 +4459,21 @@ "peer": true }, "fast-xml-builder": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.0.tgz", - "integrity": "sha512-7mtITW/we2/wTUZqMyBOR2F8xP4CRxMiSEcQxPIqdRWdO2L/HZSOlzoNyghmyDwNB8BDxePooV1ZTJpkOUhdRg==", + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz", + "integrity": "sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==", "requires": { - "path-expression-matcher": "^1.1.2" + "path-expression-matcher": "^1.1.3" } }, "fast-xml-parser": { - "version": "5.5.1", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.1.tgz", - "integrity": "sha512-JTpMz8P5mDoNYzXTmTT/xzWjFiCWi0U+UQTJtrFH9muXsr2RqtXZPbnCW5h2mKsOd4u3XcPWCvDSrnaBPlUcMQ==", + "version": "5.5.9", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.9.tgz", + "integrity": "sha512-jldvxr1MC6rtiZKgrFnDSvT8xuH+eJqxqOBThUVjYrxssYTo1avZLGql5l0a0BAERR01CadYzZ83kVEkbyDg+g==", "requires": { - "fast-xml-builder": "^1.1.0", - "path-expression-matcher": "^1.1.2", - "strnum": "^2.1.2" + "fast-xml-builder": "^1.1.4", + "path-expression-matcher": "^1.2.0", + "strnum": "^2.2.2" } }, "fill-range": { @@ -4417,9 +4490,9 @@ "integrity": "sha512-k6GAGDyqLe9JaebCsFCoudPPWfihKu8pylYXRlqP1J7ms39iPoTtk2fviNglIeQEwdh0bQeKJ01ZPyuyQvKzwg==" }, "form-data": { - "version": "4.0.5", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.5.tgz", - "integrity": "sha512-8RipRLol37bNs2bhoV67fiTEvdTrbMUYcFTiy3+wuuOnUog2QBHCZWXDRijWQfAkhBj2Uf5UnVaiWwA5vdd82w==", + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz", + "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==", "requires": { "asynckit": "^0.4.0", "combined-stream": "^1.0.8", @@ -4444,29 +4517,21 @@ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==" }, - "generator-function": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/generator-function/-/generator-function-2.0.1.tgz", - "integrity": "sha512-SFdFmIJi+ybC0vjlHN0ZGVGHc3lgE0DxPAT0djjVg+kjOnSqclqmj0KQ7ykTOLP6YxoqOvuAODGdcHJn+43q3g==" - }, "get-caller-file": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==" }, "get-intrinsic": { - "version": "1.3.1", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.1.tgz", - "integrity": "sha512-fk1ZVEeOX9hVZ6QzoBNEC55+Ucqg4sTVwrVuigZhuRPESVFpMyXnd3sbXvPOwp7Y9riVyANiqhEuRF0G1aVSeQ==", + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", + "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", "requires": { - "async-function": "^1.0.0", - "async-generator-function": "^1.0.0", "call-bind-apply-helpers": "^1.0.2", "es-define-property": "^1.0.1", "es-errors": "^1.3.0", "es-object-atoms": "^1.1.1", "function-bind": "^1.1.2", - "generator-function": "^2.0.0", "get-proto": "^1.0.1", "gopd": "^1.2.0", "has-symbols": "^1.1.0", @@ -4475,9 +4540,9 @@ } }, "get-port-please": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.2.0.tgz", - "integrity": "sha512-I9QVvBw5U/hw3RmWpYKRumUeaDgxTPd401x364rLmWBJcOQ753eov1eTgzDqRG9bqFIfDc7gfzcQEWrUri3o1A==" + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.0.1.tgz", + "integrity": "sha512-R5pcVO8Z1+pVDu8Ml3xaJCEkBiiy1VQN9za0YqH8GIi1nIqD4IzQhzY6dDzMRtdS1lyiGlucRzm8IN8wtLIXng==" }, "get-proto": { "version": "1.0.1", @@ -4782,9 +4847,9 @@ "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==" }, "js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", + "version": "4.1.1", + "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", + "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", "requires": { "argparse": "^2.0.1" } @@ -4895,19 +4960,17 @@ "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==" }, + "mime-db": { + "version": "1.52.0", + "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", + "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==" + }, "mime-types": { "version": "2.1.35", "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", "requires": { "mime-db": "1.52.0" - }, - "dependencies": { - "mime-db": { - "version": "1.52.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", - "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==" - } } }, "minimatch": { @@ -4935,7 +4998,8 @@ "mobx": { "version": "6.15.0", "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.0.tgz", - "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==" + "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==", + "peer": true }, "mobx-react": { "version": "9.2.1", @@ -5089,14 +5153,14 @@ } }, "open": { - "version": "10.2.0", - "resolved": "https://registry.npmjs.org/open/-/open-10.2.0.tgz", - "integrity": "sha512-YgBpdJHPyQ2UE5x+hlSXcnejzAvD0b22U2OuAP+8OnlJT+PjWPxtgmGqKKc+RgTM63U9gN0YzrYc71R2WT/hTA==", + "version": "10.1.0", + "resolved": "https://registry.npmjs.org/open/-/open-10.1.0.tgz", + "integrity": "sha512-mnkeQ1qP5Ue2wd+aivTD3NHd/lZ96Lu0jgf0pwktLPtx6cTZiH7tyeGRRHs0zX0rbrahXPnXlUnbeXyaBBuIaw==", "requires": { "default-browser": "^5.2.1", "define-lazy-prop": "^3.0.0", "is-inside-container": "^1.0.0", - "wsl-utils": "^0.1.0" + "is-wsl": "^3.1.0" } }, "openapi-sampler": { @@ -5142,9 +5206,9 @@ "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==" }, "path-expression-matcher": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.1.2.tgz", - "integrity": "sha512-LXWqJmcpp2BKOEmgt4CyuESFmBfPuhJlAHKJsFzuJU6CxErWk75BrO+Ni77M9OxHN6dCYKM4vj+21Z6cOL96YQ==" + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz", + "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==" }, "path-is-absolute": { "version": "1.0.1", @@ -5168,9 +5232,9 @@ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==" }, "picomatch": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", - "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==" + "version": "2.3.2", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", + "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==" }, "pluralize": { "version": "8.0.0", @@ -5325,6 +5389,16 @@ "npm-normalize-package-bin": "^1.0.0" } }, + "readable-stream": { + "version": "3.6.2", + "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", + "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", + "requires": { + "inherits": "^2.0.3", + "string_decoder": "^1.1.1", + "util-deprecate": "^1.0.1" + } + }, "readdir-scoped-modules": { "version": "1.1.0", "resolved": "https://registry.npmjs.org/readdir-scoped-modules/-/readdir-scoped-modules-1.1.0.tgz", @@ -5421,9 +5495,9 @@ "dev": true }, "set-cookie-parser": { - "version": "2.7.2", - "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", - "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==" + "version": "2.7.1", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.1.tgz", + "integrity": "sha512-IOc8uWeOZgnb3ptbCURJWNjWUPcO3ZnTTdzsurqERrP6nPyv+paC55vJM0LpOlT2ne+Ix+9+CRG1MNLlyZ4GjQ==" }, "shallowequal": { "version": "1.1.0", @@ -5488,18 +5562,6 @@ "randombytes": "^2.1.0", "readable-stream": "^3.6.0", "ws": "^7.4.2" - }, - "dependencies": { - "readable-stream": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", - "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "requires": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - } - } } }, "slide": { @@ -5615,30 +5677,30 @@ } }, "strnum": { - "version": "2.2.0", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.0.tgz", - "integrity": "sha512-Y7Bj8XyJxnPAORMZj/xltsfo55uOiyHcU2tnAVzHUnSJR/KsEX+9RoDeXEnsXtl/CX4fAcrt64gZ13aGaWPeBg==" + "version": "2.2.2", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.2.tgz", + "integrity": "sha512-DnR90I+jtXNSTXWdwrEy9FakW7UX+qUZg28gj5fk2vxxl7uS/3bpI4fjFYVmdK9etptYBPNkpahuQnEwhwECqA==" }, "styled-components": { - "version": "6.1.19", - "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.1.19.tgz", - "integrity": "sha512-1v/e3Dl1BknC37cXMhwGomhO8AkYmN41CqyX9xhUDxry1ns3BFQy2lLDRQXJRdVVWB9OHemv/53xaStimvWyuA==", + "version": "6.3.9", + "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.3.9.tgz", + "integrity": "sha512-J72R4ltw0UBVUlEjTzI0gg2STOqlI9JBhQOL4Dxt7aJOnnSesy0qJDn4PYfMCafk9cWOaVg129Pesl5o+DIh0Q==", "requires": { - "@emotion/is-prop-valid": "1.2.2", - "@emotion/unitless": "0.8.1", - "@types/stylis": "4.2.5", + "@emotion/is-prop-valid": "1.4.0", + "@emotion/unitless": "0.10.0", + "@types/stylis": "4.2.7", "css-to-react-native": "3.2.0", - "csstype": "3.1.3", + "csstype": "3.2.3", "postcss": "8.4.49", "shallowequal": "1.1.0", - "stylis": "4.3.2", - "tslib": "2.6.2" + "stylis": "4.3.6", + "tslib": "2.8.1" } }, "stylis": { - "version": "4.3.2", - "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.2.tgz", - "integrity": "sha512-bhtUjWd/z6ltJiQwg0dUfxEJ+W+jdqQd8TbWLWyeIJHlnsqmGLRFFd8e5mA0AZi/zx90smXRlN66YMTcaSFifg==" + "version": "4.3.6", + "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.6.tgz", + "integrity": "sha512-yQ3rwFWRfwNUY7H5vpU0wfdkNSnvnJinhF9830Swlaxl03zsOjCfmX0ugac+3LtK0lYSgwL/KXc8oYL3mG4YFQ==" }, "supports-color": { "version": "5.5.0", @@ -5693,9 +5755,9 @@ "dev": true }, "tslib": { - "version": "2.6.2", - "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.6.2.tgz", - "integrity": "sha512-AEYxH93jGFPn/a2iVAwW87VuUIkR1FVUKB77NwMF7nBTDkDrrT/Hpt/IrCJ0QXhW27jTBDcf5ZY7w6RiqTMw2Q==" + "version": "2.8.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", + "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==" }, "typedarray": { "version": "0.0.6", @@ -5818,23 +5880,15 @@ "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==", "requires": {} }, - "wsl-utils": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/wsl-utils/-/wsl-utils-0.1.0.tgz", - "integrity": "sha512-h3Fbisa2nKGPxCpm89Hk33lBLsnaGBvctQopaBSOW/uIs6FTe1ATyAnKFJrzVs9vpGdsTe73WF3V4lIsk4Gacw==", - "requires": { - "is-wsl": "^3.1.0" - } - }, "y18n": { "version": "5.0.8", "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==" }, "yaml": { - "version": "1.10.2", - "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.2.tgz", - "integrity": "sha512-r3vXyErRCYJ7wg28yvBY5VSoAF8ZvlcW9/BwUzEtUsjvX/DKs24dIkuwjtuprwJJHsbyUbLApepYTR1BN4uHrg==" + "version": "1.10.3", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", + "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==" }, "yaml-ast-parser": { "version": "0.0.43", diff --git a/poetry.lock b/poetry.lock index 82c7a3bc9..79b3ee75d 100644 --- a/poetry.lock +++ b/poetry.lock @@ -14,14 +14,14 @@ files = [ [[package]] name = "attrs" -version = "25.4.0" +version = "26.1.0" description = "Classes Without Boilerplate" optional = false python-versions = ">=3.9" groups = ["main"] files = [ - {file = "attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373"}, - {file = "attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11"}, + {file = "attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309"}, + {file = "attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32"}, ] [[package]] @@ -92,14 +92,14 @@ uvloop = ["uvloop (>=0.15.2) ; sys_platform != \"win32\"", "winloop (>=0.5.0) ; [[package]] name = "certifi" -version = "2025.11.12" +version = "2026.2.25" description = "Python package for providing Mozilla's CA Bundle." optional = false python-versions = ">=3.7" groups = ["main", "dev"] files = [ - {file = "certifi-2025.11.12-py3-none-any.whl", hash = "sha256:97de8790030bbd5c2d96b7ec782fc2f7820ef8dba6db909ccf95449f2d062d4b"}, - {file = "certifi-2025.11.12.tar.gz", hash = "sha256:d8ab5478f2ecd78af242878415affce761ca6bc54a22a27e026d7c25357c3316"}, + {file = "certifi-2026.2.25-py3-none-any.whl", hash = "sha256:027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa"}, + {file = "certifi-2026.2.25.tar.gz", hash = "sha256:e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7"}, ] [[package]] @@ -202,125 +202,141 @@ pycparser = {version = "*", markers = "implementation_name != \"PyPy\""} [[package]] name = "charset-normalizer" -version = "3.4.4" +version = "3.4.6" description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet." optional = false python-versions = ">=3.7" groups = ["main", "dev"] files = [ - {file = "charset_normalizer-3.4.4-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e824f1492727fa856dd6eda4f7cee25f8518a12f3c4a56a74e8095695089cf6d"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4bd5d4137d500351a30687c2d3971758aac9a19208fc110ccb9d7188fbe709e8"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:027f6de494925c0ab2a55eab46ae5129951638a49a34d87f4c3eda90f696b4ad"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f820802628d2694cb7e56db99213f930856014862f3fd943d290ea8438d07ca8"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:798d75d81754988d2565bff1b97ba5a44411867c0cf32b77a7e8f8d84796b10d"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d1bb833febdff5c8927f922386db610b49db6e0d4f4ee29601d71e7c2694313"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9cd98cdc06614a2f768d2b7286d66805f94c48cde050acdbbb7db2600ab3197e"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:077fbb858e903c73f6c9db43374fd213b0b6a778106bc7032446a8e8b5b38b93"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:244bfb999c71b35de57821b8ea746b24e863398194a4014e4c76adc2bbdfeff0"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:64b55f9dce520635f018f907ff1b0df1fdc31f2795a922fb49dd14fbcdf48c84"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:faa3a41b2b66b6e50f84ae4a68c64fcd0c44355741c6374813a800cd6695db9e"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:6515f3182dbe4ea06ced2d9e8666d97b46ef4c75e326b79bb624110f122551db"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:cc00f04ed596e9dc0da42ed17ac5e596c6ccba999ba6bd92b0e0aef2f170f2d6"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-win32.whl", hash = "sha256:f34be2938726fc13801220747472850852fe6b1ea75869a048d6f896838c896f"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-win_amd64.whl", hash = "sha256:a61900df84c667873b292c3de315a786dd8dac506704dea57bc957bd31e22c7d"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-win_arm64.whl", hash = "sha256:cead0978fc57397645f12578bfd2d5ea9138ea0fac82b2f63f7f7c6877986a69"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6e1fcf0720908f200cd21aa4e6750a48ff6ce4afe7ff5a79a90d5ed8a08296f8"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f819d5fe9234f9f82d75bdfa9aef3a3d72c4d24a6e57aeaebba32a704553aa0"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a59cb51917aa591b1c4e6a43c132f0cdc3c76dbad6155df4e28ee626cc77a0a3"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8ef3c867360f88ac904fd3f5e1f902f13307af9052646963ee08ff4f131adafc"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d9e45d7faa48ee908174d8fe84854479ef838fc6a705c9315372eacbc2f02897"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:840c25fb618a231545cbab0564a799f101b63b9901f2569faecd6b222ac72381"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ca5862d5b3928c4940729dacc329aa9102900382fea192fc5e52eb69d6093815"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9c7f57c3d666a53421049053eaacdd14bbd0a528e2186fcb2e672effd053bb0"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:277e970e750505ed74c832b4bf75dac7476262ee2a013f5574dd49075879e161"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:31fd66405eaf47bb62e8cd575dc621c56c668f27d46a61d975a249930dd5e2a4"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:0d3d8f15c07f86e9ff82319b3d9ef6f4bf907608f53fe9d92b28ea9ae3d1fd89"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:9f7fcd74d410a36883701fafa2482a6af2ff5ba96b9a620e9e0721e28ead5569"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ebf3e58c7ec8a8bed6d66a75d7fb37b55e5015b03ceae72a8e7c74495551e224"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-win32.whl", hash = "sha256:eecbc200c7fd5ddb9a7f16c7decb07b566c29fa2161a16cf67b8d068bd21690a"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-win_amd64.whl", hash = "sha256:5ae497466c7901d54b639cf42d5b8c1b6a4fead55215500d2f486d34db48d016"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-win_arm64.whl", hash = "sha256:65e2befcd84bc6f37095f5961e68a6f077bf44946771354a28ad434c2cce0ae1"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:ce8a0633f41a967713a59c4139d29110c07e826d131a316b50ce11b1d79b4f84"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaabd426fe94daf8fd157c32e571c85cb12e66692f15516a83a03264b08d06c3"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c4ef880e27901b6cc782f1b95f82da9313c0eb95c3af699103088fa0ac3ce9ac"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2aaba3b0819274cc41757a1da876f810a3e4d7b6eb25699253a4effef9e8e4af"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:778d2e08eda00f4256d7f672ca9fef386071c9202f5e4607920b86d7803387f2"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f155a433c2ec037d4e8df17d18922c3a0d9b3232a396690f17175d2946f0218d"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a8bf8d0f749c5757af2142fe7903a9df1d2e8aa3841559b2bad34b08d0e2bcf3"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:194f08cbb32dc406d6e1aea671a68be0823673db2832b38405deba2fb0d88f63"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:6aee717dcfead04c6eb1ce3bd29ac1e22663cdea57f943c87d1eab9a025438d7"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:cd4b7ca9984e5e7985c12bc60a6f173f3c958eae74f3ef6624bb6b26e2abbae4"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:b7cf1017d601aa35e6bb650b6ad28652c9cd78ee6caff19f3c28d03e1c80acbf"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:e912091979546adf63357d7e2ccff9b44f026c075aeaf25a52d0e95ad2281074"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:5cb4d72eea50c8868f5288b7f7f33ed276118325c1dfd3957089f6b519e1382a"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-win32.whl", hash = "sha256:837c2ce8c5a65a2035be9b3569c684358dfbf109fd3b6969630a87535495ceaa"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-win_amd64.whl", hash = "sha256:44c2a8734b333e0578090c4cd6b16f275e07aa6614ca8715e6c038e865e70576"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:a9768c477b9d7bd54bc0c86dbaebdec6f03306675526c9927c0e8a04e8f94af9"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1bee1e43c28aa63cb16e5c14e582580546b08e535299b8b6158a7c9c768a1f3d"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:fd44c878ea55ba351104cb93cc85e74916eb8fa440ca7903e57575e97394f608"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0f04b14ffe5fdc8c4933862d8306109a2c51e0704acfa35d51598eb45a1e89fc"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:cd09d08005f958f370f539f186d10aec3377d55b9eeb0d796025d4886119d76e"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4fe7859a4e3e8457458e2ff592f15ccb02f3da787fcd31e0183879c3ad4692a1"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fa09f53c465e532f4d3db095e0c55b615f010ad81803d383195b6b5ca6cbf5f3"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:7fa17817dc5625de8a027cb8b26d9fefa3ea28c8253929b8d6649e705d2835b6"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:5947809c8a2417be3267efc979c47d76a079758166f7d43ef5ae8e9f92751f88"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:4902828217069c3c5c71094537a8e623f5d097858ac6ca8252f7b4d10b7560f1"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:7c308f7e26e4363d79df40ca5b2be1c6ba9f02bdbccfed5abddb7859a6ce72cf"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:2c9d3c380143a1fedbff95a312aa798578371eb29da42106a29019368a475318"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:cb01158d8b88ee68f15949894ccc6712278243d95f344770fa7593fa2d94410c"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-win32.whl", hash = "sha256:2677acec1a2f8ef614c6888b5b4ae4060cc184174a938ed4e8ef690e15d3e505"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-win_amd64.whl", hash = "sha256:f8e160feb2aed042cd657a72acc0b481212ed28b1b9a95c0cee1621b524e1966"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-win_arm64.whl", hash = "sha256:b5d84d37db046c5ca74ee7bb47dd6cbc13f80665fdde3e8040bdd3fb015ecb50"}, - {file = "charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f"}, - {file = "charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:2e1d8ca8611099001949d1cdfaefc510cf0f212484fe7c565f735b68c78c3c95"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e25369dc110d58ddf29b949377a93e0716d72a24f62bad72b2b39f155949c1fd"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:259695e2ccc253feb2a016303543d691825e920917e31f894ca1a687982b1de4"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:dda86aba335c902b6149a02a55b38e96287157e609200811837678214ba2b1db"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:51fb3c322c81d20567019778cb5a4a6f2dc1c200b886bc0d636238e364848c89"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:4482481cb0572180b6fd976a4d5c72a30263e98564da68b86ec91f0fe35e8565"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:39f5068d35621da2881271e5c3205125cc456f54e9030d3f723288c873a71bf9"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:8bea55c4eef25b0b19a0337dc4e3f9a15b00d569c77211fa8cde38684f234fb7"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:f0cdaecd4c953bfae0b6bb64910aaaca5a424ad9c72d85cb88417bb9814f7550"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:150b8ce8e830eb7ccb029ec9ca36022f756986aaaa7956aad6d9ec90089338c0"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:e68c14b04827dd76dcbd1aeea9e604e3e4b78322d8faf2f8132c7138efa340a8"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:3778fd7d7cd04ae8f54651f4a7a0bd6e39a0cf20f801720a4c21d80e9b7ad6b0"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:dad6e0f2e481fffdcf776d10ebee25e0ef89f16d691f1e5dee4b586375fdc64b"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-win32.whl", hash = "sha256:74a2e659c7ecbc73562e2a15e05039f1e22c75b7c7618b4b574a3ea9118d1557"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-win_amd64.whl", hash = "sha256:aa9cccf4a44b9b62d8ba8b4dd06c649ba683e4bf04eea606d2e94cfc2d6ff4d6"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-win_arm64.whl", hash = "sha256:e985a16ff513596f217cee86c21371b8cd011c0f6f056d0920aa2d926c544058"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:82060f995ab5003a2d6e0f4ad29065b7672b6593c8c63559beefe5b443242c3e"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:60c74963d8350241a79cb8feea80e54d518f72c26db618862a8f53e5023deaf9"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6e4333fb15c83f7d1482a76d45a0818897b3d33f00efd215528ff7c51b8e35d"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bc72863f4d9aba2e8fd9085e63548a324ba706d2ea2c83b260da08a59b9482de"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9cc4fc6c196d6a8b76629a70ddfcd4635a6898756e2d9cac5565cf0654605d73"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:0c173ce3a681f309f31b87125fecec7a5d1347261ea11ebbb856fa6006b23c8c"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c907cdc8109f6c619e6254212e794d6548373cc40e1ec75e6e3823d9135d29cc"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:404a1e552cf5b675a87f0651f8b79f5f1e6fd100ee88dc612f89aa16abd4486f"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:e3c701e954abf6fc03a49f7c579cc80c2c6cc52525340ca3186c41d3f33482ef"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:7a6967aaf043bceabab5412ed6bd6bd26603dae84d5cb75bf8d9a74a4959d398"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5feb91325bbceade6afab43eb3b508c63ee53579fe896c77137ded51c6b6958e"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:f820f24b09e3e779fe84c3c456cb4108a7aa639b0d1f02c28046e11bfcd088ed"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:b35b200d6a71b9839a46b9b7fff66b6638bb52fc9658aa58796b0326595d3021"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-win32.whl", hash = "sha256:9ca4c0b502ab399ef89248a2c84c54954f77a070f28e546a85e91da627d1301e"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-win_amd64.whl", hash = "sha256:a9e68c9d88823b274cf1e72f28cb5dc89c990edf430b0bfd3e2fb0785bfeabf4"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-win_arm64.whl", hash = "sha256:97d0235baafca5f2b09cf332cc275f021e694e8362c6bb9c96fc9a0eb74fc316"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:2ef7fedc7a6ecbe99969cd09632516738a97eeb8bd7258bf8a0f23114c057dab"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a4ea868bc28109052790eb2b52a9ab33f3aa7adc02f96673526ff47419490e21"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:836ab36280f21fc1a03c99cd05c6b7af70d2697e374c7af0b61ed271401a72a2"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f1ce721c8a7dfec21fcbdfe04e8f68174183cf4e8188e0645e92aa23985c57ff"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e28d62a8fc7a1fa411c43bd65e346f3bce9716dc51b897fbe930c5987b402d5"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:530d548084c4a9f7a16ed4a294d459b4f229db50df689bfe92027452452943a0"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:30f445ae60aad5e1f8bdbb3108e39f6fbc09f4ea16c815c66578878325f8f15a"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ac2393c73378fea4e52aa56285a3d64be50f1a12395afef9cce47772f60334c2"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:90ca27cd8da8118b18a52d5f547859cc1f8354a00cd1e8e5120df3e30d6279e5"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:8e5a94886bedca0f9b78fecd6afb6629142fd2605aa70a125d49f4edc6037ee6"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:695f5c2823691a25f17bc5d5ffe79fa90972cc34b002ac6c843bb8a1720e950d"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:231d4da14bcd9301310faf492051bee27df11f2bc7549bc0bb41fef11b82daa2"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a056d1ad2633548ca18ffa2f85c202cfb48b68615129143915b8dc72a806a923"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-win32.whl", hash = "sha256:c2274ca724536f173122f36c98ce188fd24ce3dad886ec2b7af859518ce008a4"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-win_amd64.whl", hash = "sha256:c8ae56368f8cc97c7e40a7ee18e1cedaf8e780cd8bc5ed5ac8b81f238614facb"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-win_arm64.whl", hash = "sha256:899d28f422116b08be5118ef350c292b36fc15ec2daeb9ea987c89281c7bb5c4"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:11afb56037cbc4b1555a34dd69151e8e069bee82e613a73bef6e714ce733585f"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:423fb7e748a08f854a08a222b983f4df1912b1daedce51a72bd24fe8f26a1843"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d73beaac5e90173ac3deb9928a74763a6d230f494e4bfb422c217a0ad8e629bf"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d60377dce4511655582e300dc1e5a5f24ba0cb229005a1d5c8d0cb72bb758ab8"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:530e8cebeea0d76bdcf93357aa5e41336f48c3dc709ac52da2bb167c5b8271d9"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:a26611d9987b230566f24a0a125f17fe0de6a6aff9f25c9f564aaa2721a5fb88"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:34315ff4fc374b285ad7f4a0bf7dcbfe769e1b104230d40f49f700d4ab6bbd84"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5f8ddd609f9e1af8c7bd6e2aca279c931aefecd148a14402d4e368f3171769fd"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:80d0a5615143c0b3225e5e3ef22c8d5d51f3f72ce0ea6fb84c943546c7b25b6c"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:92734d4d8d187a354a556626c221cd1a892a4e0802ccb2af432a1d85ec012194"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:613f19aa6e082cf96e17e3ffd89383343d0d589abda756b7764cf78361fd41dc"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:2b1a63e8224e401cafe7739f77efd3f9e7f5f2026bda4aead8e59afab537784f"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6cceb5473417d28edd20c6c984ab6fee6c6267d38d906823ebfe20b03d607dc2"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-win32.whl", hash = "sha256:d7de2637729c67d67cf87614b566626057e95c303bc0a55ffe391f5205e7003d"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-win_amd64.whl", hash = "sha256:572d7c822caf521f0525ba1bce1a622a0b85cf47ffbdae6c9c19e3b5ac3c4389"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-win_arm64.whl", hash = "sha256:a4474d924a47185a06411e0064b803c68be044be2d60e50e8bddcc2649957c1f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:9cc6e6d9e571d2f863fa77700701dae73ed5f78881efc8b3f9a4398772ff53e8"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef5960d965e67165d75b7c7ffc60a83ec5abfc5c11b764ec13ea54fbef8b4421"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b3694e3f87f8ac7ce279d4355645b3c878d24d1424581b46282f24b92f5a4ae2"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5d11595abf8dd942a77883a39d81433739b287b6aa71620f15164f8096221b30"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7bda6eebafd42133efdca535b04ccb338ab29467b3f7bf79569883676fc628db"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:bbc8c8650c6e51041ad1be191742b8b421d05bbd3410f43fa2a00c8db87678e8"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:22c6f0c2fbc31e76c3b8a86fba1a56eda6166e238c29cdd3d14befdb4a4e4815"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7edbed096e4a4798710ed6bc75dcaa2a21b68b6c356553ac4823c3658d53743a"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:7f9019c9cb613f084481bd6a100b12e1547cf2efe362d873c2e31e4035a6fa43"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:58c948d0d086229efc484fe2f30c2d382c86720f55cd9bc33591774348ad44e0"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:419a9d91bd238052642a51938af8ac05da5b3343becde08d5cdeab9046df9ee1"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:5273b9f0b5835ff0350c0828faea623c68bfa65b792720c453e22b25cc72930f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:0e901eb1049fdb80f5bd11ed5ea1e498ec423102f7a9b9e4645d5b8204ff2815"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-win32.whl", hash = "sha256:b4ff1d35e8c5bd078be89349b6f3a845128e685e751b6ea1169cf2160b344c4d"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-win_amd64.whl", hash = "sha256:74119174722c4349af9708993118581686f343adc1c8c9c007d59be90d077f3f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-win_arm64.whl", hash = "sha256:e5bcc1a1ae744e0bb59641171ae53743760130600da8db48cbb6e4918e186e4e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ad8faf8df23f0378c6d527d8b0b15ea4a2e23c89376877c598c4870d1b2c7866"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f5ea69428fa1b49573eef0cc44a1d43bebd45ad0c611eb7d7eac760c7ae771bc"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:06a7e86163334edfc5d20fe104db92fcd666e5a5df0977cb5680a506fe26cc8e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e1f6e2f00a6b8edb562826e4632e26d063ac10307e80f7461f7de3ad8ef3f077"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95b52c68d64c1878818687a473a10547b3292e82b6f6fe483808fb1468e2f52f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:7504e9b7dc05f99a9bbb4525c67a2c155073b44d720470a148b34166a69c054e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:172985e4ff804a7ad08eebec0a1640ece87ba5041d565fff23c8f99c1f389484"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:4be9f4830ba8741527693848403e2c457c16e499100963ec711b1c6f2049b7c7"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:79090741d842f564b1b2827c0b82d846405b744d31e84f18d7a7b41c20e473ff"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:87725cfb1a4f1f8c2fc9890ae2f42094120f4b44db9360be5d99a4c6b0e03a9e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:fcce033e4021347d80ed9c66dcf1e7b1546319834b74445f561d2e2221de5659"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:ca0276464d148c72defa8bb4390cce01b4a0e425f3b50d1435aa6d7a18107602"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:197c1a244a274bb016dd8b79204850144ef77fe81c5b797dc389327adb552407"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-win32.whl", hash = "sha256:2a24157fa36980478dd1770b585c0f30d19e18f4fb0c47c13aa568f871718579"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-win_amd64.whl", hash = "sha256:cd5e2801c89992ed8c0a3f0293ae83c159a60d9a5d685005383ef4caca77f2c4"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-win_arm64.whl", hash = "sha256:47955475ac79cc504ef2704b192364e51d0d473ad452caedd0002605f780101c"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:659a1e1b500fac8f2779dd9e1570464e012f43e580371470b45277a27baa7532"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f61aa92e4aad0be58eb6eb4e0c21acf32cf8065f4b2cae5665da756c4ceef982"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f50498891691e0864dc3da965f340fada0771f6142a378083dc4608f4ea513e2"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bf625105bb9eef28a56a943fec8c8a98aeb80e7d7db99bd3c388137e6eb2d237"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2bd9d128ef93637a5d7a6af25363cf5dec3fa21cf80e68055aad627f280e8afa"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux_2_31_armv7l.whl", hash = "sha256:d08ec48f0a1c48d75d0356cea971921848fb620fdeba805b28f937e90691209f"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1ed80ff870ca6de33f4d953fda4d55654b9a2b340ff39ab32fa3adbcd718f264"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:f98059e4fcd3e3e4e2d632b7cf81c2faae96c43c60b569e9c621468082f1d104"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:ab30e5e3e706e3063bc6de96b118688cb10396b70bb9864a430f67df98c61ecc"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:d5f5d1e9def3405f60e3ca8232d56f35c98fb7bf581efcc60051ebf53cb8b611"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:461598cd852bfa5a61b09cae2b1c02e2efcd166ee5516e243d540ac24bfa68a7"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:71be7e0e01753a89cf024abf7ecb6bca2c81738ead80d43004d9b5e3f1244e64"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:df01808ee470038c3f8dc4f48620df7225c49c2d6639e38f96e6d6ac6e6f7b0e"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-win32.whl", hash = "sha256:69dd852c2f0ad631b8b60cfbe25a28c0058a894de5abb566619c205ce0550eae"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-win_amd64.whl", hash = "sha256:517ad0e93394ac532745129ceabdf2696b609ec9f87863d337140317ebce1c14"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:31215157227939b4fb3d740cd23fe27be0439afef67b785a1eb78a3ae69cba9e"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ecbbd45615a6885fe3240eb9db73b9e62518b611850fdf8ab08bd56de7ad2b17"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c45a03a4c69820a399f1dda9e1d8fbf3562eda46e7720458180302021b08f778"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e8aeb10fcbe92767f0fa69ad5a72deca50d0dca07fbde97848997d778a50c9fe"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:54fae94be3d75f3e573c9a1b5402dc593de19377013c9a0e4285e3d402dd3a2a"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux_2_31_armv7l.whl", hash = "sha256:2f7fdd9b6e6c529d6a2501a2d36b240109e78a8ceaef5687cfcfa2bbe671d297"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:4d1d02209e06550bdaef34af58e041ad71b88e624f5d825519da3a3308e22687"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:8bc5f0687d796c05b1e28ab0d38a50e6309906ee09375dd3aff6a9c09dd6e8f4"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:ee4ec14bc1680d6b0afab9aea2ef27e26d2024f18b24a2d7155a52b60da7e833"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:d1a2ee9c1499fc8f86f4521f27a973c914b211ffa87322f4ee33bb35392da2c5"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:48696db7f18afb80a068821504296eb0787d9ce239b91ca15059d1d3eaacf13b"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:4f41da960b196ea355357285ad1316a00099f22d0929fe168343b99b254729c9"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:802168e03fba8bbc5ce0d866d589e4b1ca751d06edee69f7f3a19c5a9fe6b597"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-win32.whl", hash = "sha256:8761ac29b6c81574724322a554605608a9960769ea83d2c73e396f3df896ad54"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-win_amd64.whl", hash = "sha256:1cf0a70018692f85172348fe06d3a4b63f94ecb055e13a00c644d368eb82e5b8"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-win_arm64.whl", hash = "sha256:3516bbb8d42169de9e61b8520cbeeeb716f12f4ecfe3fd30a9919aa16c806ca8"}, + {file = "charset_normalizer-3.4.6-py3-none-any.whl", hash = "sha256:947cf925bc916d90adba35a64c82aace04fa39b46b52d4630ece166655905a69"}, + {file = "charset_normalizer-3.4.6.tar.gz", hash = "sha256:1ae6b62897110aa7c79ea2f5dd38d1abca6db663687c0b1ad9aed6f6bae3d9d6"}, ] [[package]] @@ -353,61 +369,61 @@ markers = {main = "sys_platform == \"win32\"", dev = "sys_platform == \"win32\" [[package]] name = "cryptography" -version = "46.0.5" +version = "46.0.6" description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers." optional = false python-versions = "!=3.9.0,!=3.9.1,>=3.8" groups = ["dev"] files = [ - {file = "cryptography-46.0.5-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:351695ada9ea9618b3500b490ad54c739860883df6c1f555e088eaf25b1bbaad"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c18ff11e86df2e28854939acde2d003f7984f721eba450b56a200ad90eeb0e6b"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4d7e3d356b8cd4ea5aff04f129d5f66ebdc7b6f8eae802b93739ed520c47c79b"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:50bfb6925eff619c9c023b967d5b77a54e04256c4281b0e21336a130cd7fc263"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:803812e111e75d1aa73690d2facc295eaefd4439be1023fefc4995eaea2af90d"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:3ee190460e2fbe447175cda91b88b84ae8322a104fc27766ad09428754a618ed"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:f145bba11b878005c496e93e257c1e88f154d278d2638e6450d17e0f31e558d2"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:e9251e3be159d1020c4030bd2e5f84d6a43fe54b6c19c12f51cde9542a2817b2"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:47fb8a66058b80e509c47118ef8a75d14c455e81ac369050f20ba0d23e77fee0"}, - {file = "cryptography-46.0.5-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:4c3341037c136030cb46e4b1e17b7418ea4cbd9dd207e4a6f3b2b24e0d4ac731"}, - {file = "cryptography-46.0.5-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:890bcb4abd5a2d3f852196437129eb3667d62630333aacc13dfd470fad3aaa82"}, - {file = "cryptography-46.0.5-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:80a8d7bfdf38f87ca30a5391c0c9ce4ed2926918e017c29ddf643d0ed2778ea1"}, - {file = "cryptography-46.0.5-cp311-abi3-win32.whl", hash = "sha256:60ee7e19e95104d4c03871d7d7dfb3d22ef8a9b9c6778c94e1c8fcc8365afd48"}, - {file = "cryptography-46.0.5-cp311-abi3-win_amd64.whl", hash = "sha256:38946c54b16c885c72c4f59846be9743d699eee2b69b6988e0a00a01f46a61a4"}, - {file = "cryptography-46.0.5-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:94a76daa32eb78d61339aff7952ea819b1734b46f73646a07decb40e5b3448e2"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:5be7bf2fb40769e05739dd0046e7b26f9d4670badc7b032d6ce4db64dddc0678"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:fe346b143ff9685e40192a4960938545c699054ba11d4f9029f94751e3f71d87"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:c69fd885df7d089548a42d5ec05be26050ebcd2283d89b3d30676eb32ff87dee"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:8293f3dea7fc929ef7240796ba231413afa7b68ce38fd21da2995549f5961981"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:1abfdb89b41c3be0365328a410baa9df3ff8a9110fb75e7b52e66803ddabc9a9"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:d66e421495fdb797610a08f43b05269e0a5ea7f5e652a89bfd5a7d3c1dee3648"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:4e817a8920bfbcff8940ecfd60f23d01836408242b30f1a708d93198393a80b4"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:68f68d13f2e1cb95163fa3b4db4bf9a159a418f5f6e7242564fc75fcae667fd0"}, - {file = "cryptography-46.0.5-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:a3d1fae9863299076f05cb8a778c467578262fae09f9dc0ee9b12eb4268ce663"}, - {file = "cryptography-46.0.5-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:c4143987a42a2397f2fc3b4d7e3a7d313fbe684f67ff443999e803dd75a76826"}, - {file = "cryptography-46.0.5-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:7d731d4b107030987fd61a7f8ab512b25b53cef8f233a97379ede116f30eb67d"}, - {file = "cryptography-46.0.5-cp314-cp314t-win32.whl", hash = "sha256:c3bcce8521d785d510b2aad26ae2c966092b7daa8f45dd8f44734a104dc0bc1a"}, - {file = "cryptography-46.0.5-cp314-cp314t-win_amd64.whl", hash = "sha256:4d8ae8659ab18c65ced284993c2265910f6c9e650189d4e3f68445ef82a810e4"}, - {file = "cryptography-46.0.5-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:4108d4c09fbbf2789d0c926eb4152ae1760d5a2d97612b92d508d96c861e4d31"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7d1f30a86d2757199cb2d56e48cce14deddf1f9c95f1ef1b64ee91ea43fe2e18"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:039917b0dc418bb9f6edce8a906572d69e74bd330b0b3fea4f79dab7f8ddd235"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:ba2a27ff02f48193fc4daeadf8ad2590516fa3d0adeeb34336b96f7fa64c1e3a"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:61aa400dce22cb001a98014f647dc21cda08f7915ceb95df0c9eaf84b4b6af76"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:3ce58ba46e1bc2aac4f7d9290223cead56743fa6ab94a5d53292ffaac6a91614"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:420d0e909050490d04359e7fdb5ed7e667ca5c3c402b809ae2563d7e66a92229"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:582f5fcd2afa31622f317f80426a027f30dc792e9c80ffee87b993200ea115f1"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:bfd56bb4b37ed4f330b82402f6f435845a5f5648edf1ad497da51a8452d5d62d"}, - {file = "cryptography-46.0.5-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:a3d507bb6a513ca96ba84443226af944b0f7f47dcc9a399d110cd6146481d24c"}, - {file = "cryptography-46.0.5-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9f16fbdf4da055efb21c22d81b89f155f02ba420558db21288b3d0035bafd5f4"}, - {file = "cryptography-46.0.5-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:ced80795227d70549a411a4ab66e8ce307899fad2220ce5ab2f296e687eacde9"}, - {file = "cryptography-46.0.5-cp38-abi3-win32.whl", hash = "sha256:02f547fce831f5096c9a567fd41bc12ca8f11df260959ecc7c3202555cc47a72"}, - {file = "cryptography-46.0.5-cp38-abi3-win_amd64.whl", hash = "sha256:556e106ee01aa13484ce9b0239bca667be5004efb0aabbed28d353df86445595"}, - {file = "cryptography-46.0.5-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:3b4995dc971c9fb83c25aa44cf45f02ba86f71ee600d81091c2f0cbae116b06c"}, - {file = "cryptography-46.0.5-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:bc84e875994c3b445871ea7181d424588171efec3e185dced958dad9e001950a"}, - {file = "cryptography-46.0.5-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:2ae6971afd6246710480e3f15824ed3029a60fc16991db250034efd0b9fb4356"}, - {file = "cryptography-46.0.5-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:d861ee9e76ace6cf36a6a89b959ec08e7bc2493ee39d07ffe5acb23ef46d27da"}, - {file = "cryptography-46.0.5-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:2b7a67c9cd56372f3249b39699f2ad479f6991e62ea15800973b956f4b73e257"}, - {file = "cryptography-46.0.5-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:8456928655f856c6e1533ff59d5be76578a7157224dbd9ce6872f25055ab9ab7"}, - {file = "cryptography-46.0.5.tar.gz", hash = "sha256:abace499247268e3757271b2f1e244b36b06f8515cf27c4d49468fc9eb16e93d"}, + {file = "cryptography-46.0.6-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:64235194bad039a10bb6d2d930ab3323baaec67e2ce36215fd0952fad0930ca8"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:26031f1e5ca62fcb9d1fcb34b2b60b390d1aacaa15dc8b895a9ed00968b97b30"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9a693028b9cbe51b5a1136232ee8f2bc242e4e19d456ded3fa7c86e43c713b4a"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:67177e8a9f421aa2d3a170c3e56eca4e0128883cf52a071a7cbf53297f18b175"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:d9528b535a6c4f8ff37847144b8986a9a143585f0540fbcb1a98115b543aa463"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:22259338084d6ae497a19bae5d4c66b7ca1387d3264d1c2c0e72d9e9b6a77b97"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:760997a4b950ff00d418398ad73fbc91aa2894b5c1db7ccb45b4f68b42a63b3c"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:3dfa6567f2e9e4c5dceb8ccb5a708158a2a871052fa75c8b78cb0977063f1507"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:cdcd3edcbc5d55757e5f5f3d330dd00007ae463a7e7aa5bf132d1f22a4b62b19"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:d4e4aadb7fc1f88687f47ca20bb7227981b03afaae69287029da08096853b738"}, + {file = "cryptography-46.0.6-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:2b417edbe8877cda9022dde3a008e2deb50be9c407eef034aeeb3a8b11d9db3c"}, + {file = "cryptography-46.0.6-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:380343e0653b1c9d7e1f55b52aaa2dbb2fdf2730088d48c43ca1c7c0abb7cc2f"}, + {file = "cryptography-46.0.6-cp311-abi3-win32.whl", hash = "sha256:bcb87663e1f7b075e48c3be3ecb5f0b46c8fc50b50a97cf264e7f60242dca3f2"}, + {file = "cryptography-46.0.6-cp311-abi3-win_amd64.whl", hash = "sha256:6739d56300662c468fddb0e5e291f9b4d084bead381667b9e654c7dd81705124"}, + {file = "cryptography-46.0.6-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:2ef9e69886cbb137c2aef9772c2e7138dc581fad4fcbcf13cc181eb5a3ab6275"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7f417f034f91dcec1cb6c5c35b07cdbb2ef262557f701b4ecd803ee8cefed4f4"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d24c13369e856b94892a89ddf70b332e0b70ad4a5c43cf3e9cb71d6d7ffa1f7b"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:aad75154a7ac9039936d50cf431719a2f8d4ed3d3c277ac03f3339ded1a5e707"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:3c21d92ed15e9cfc6eb64c1f5a0326db22ca9c2566ca46d845119b45b4400361"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:4668298aef7cddeaf5c6ecc244c2302a2b8e40f384255505c22875eebb47888b"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:8ce35b77aaf02f3b59c90b2c8a05c73bac12cea5b4e8f3fbece1f5fddea5f0ca"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:c89eb37fae9216985d8734c1afd172ba4927f5a05cfd9bf0e4863c6d5465b013"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:ed418c37d095aeddf5336898a132fba01091f0ac5844e3e8018506f014b6d2c4"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:69cf0056d6947edc6e6760e5f17afe4bea06b56a9ac8a06de9d2bd6b532d4f3a"}, + {file = "cryptography-46.0.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8e7304c4f4e9490e11efe56af6713983460ee0780f16c63f219984dab3af9d2d"}, + {file = "cryptography-46.0.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b928a3ca837c77a10e81a814a693f2295200adb3352395fad024559b7be7a736"}, + {file = "cryptography-46.0.6-cp314-cp314t-win32.whl", hash = "sha256:97c8115b27e19e592a05c45d0dd89c57f81f841cc9880e353e0d3bf25b2139ed"}, + {file = "cryptography-46.0.6-cp314-cp314t-win_amd64.whl", hash = "sha256:c797e2517cb7880f8297e2c0f43bb910e91381339336f75d2c1c2cbf811b70b4"}, + {file = "cryptography-46.0.6-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:12cae594e9473bca1a7aceb90536060643128bb274fcea0fc459ab90f7d1ae7a"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:639301950939d844a9e1c4464d7e07f902fe9a7f6b215bb0d4f28584729935d8"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ed3775295fb91f70b4027aeba878d79b3e55c0b3e97eaa4de71f8f23a9f2eb77"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:8927ccfbe967c7df312ade694f987e7e9e22b2425976ddbf28271d7e58845290"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:b12c6b1e1651e42ab5de8b1e00dc3b6354fdfd778e7fa60541ddacc27cd21410"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:063b67749f338ca9c5a0b7fe438a52c25f9526b851e24e6c9310e7195aad3b4d"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:02fad249cb0e090b574e30b276a3da6a149e04ee2f049725b1f69e7b8351ec70"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:7e6142674f2a9291463e5e150090b95a8519b2fb6e6aaec8917dd8d094ce750d"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:456b3215172aeefb9284550b162801d62f5f264a081049a3e94307fe20792cfa"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:341359d6c9e68834e204ceaf25936dffeafea3829ab80e9503860dcc4f4dac58"}, + {file = "cryptography-46.0.6-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9a9c42a2723999a710445bc0d974e345c32adfd8d2fac6d8a251fa829ad31cfb"}, + {file = "cryptography-46.0.6-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:6617f67b1606dfd9fe4dbfa354a9508d4a6d37afe30306fe6c101b7ce3274b72"}, + {file = "cryptography-46.0.6-cp38-abi3-win32.whl", hash = "sha256:7f6690b6c55e9c5332c0b59b9c8a3fb232ebf059094c17f9019a51e9827df91c"}, + {file = "cryptography-46.0.6-cp38-abi3-win_amd64.whl", hash = "sha256:79e865c642cfc5c0b3eb12af83c35c5aeff4fa5c672dc28c43721c2c9fdd2f0f"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:2ea0f37e9a9cf0df2952893ad145fd9627d326a59daec9b0802480fa3bcd2ead"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:a3e84d5ec9ba01f8fd03802b2147ba77f0c8f2617b2aff254cedd551844209c8"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:12f0fa16cc247b13c43d56d7b35287ff1569b5b1f4c5e87e92cc4fcc00cd10c0"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:50575a76e2951fe7dbd1f56d181f8c5ceeeb075e9ff88e7ad997d2f42af06e7b"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:90e5f0a7b3be5f40c3a0a0eafb32c681d8d2c181fc2a1bdabe9b3f611d9f6b1a"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6728c49e3b2c180ef26f8e9f0a883a2c585638db64cf265b49c9ba10652d430e"}, + {file = "cryptography-46.0.6.tar.gz", hash = "sha256:27550628a518c5c6c903d84f637fbecf287f6cb9ced3804838a1295dc1fd0759"}, ] [package.dependencies] @@ -420,7 +436,7 @@ nox = ["nox[uv] (>=2024.4.15)"] pep8test = ["check-sdist", "click (>=8.0.1)", "mypy (>=1.14)", "ruff (>=0.11.11)"] sdist = ["build (>=1.0.0)"] ssh = ["bcrypt (>=3.1.5)"] -test = ["certifi (>=2024)", "cryptography-vectors (==46.0.5)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"] +test = ["certifi (>=2024)", "cryptography-vectors (==46.0.6)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"] test-randomorder = ["pytest-randomly"] [[package]] @@ -480,14 +496,14 @@ smmap = ">=3.0.1,<6" [[package]] name = "gitpython" -version = "3.1.45" +version = "3.1.46" description = "GitPython is a Python library used to interact with Git repositories" optional = false python-versions = ">=3.7" groups = ["main"] files = [ - {file = "gitpython-3.1.45-py3-none-any.whl", hash = "sha256:8908cb2e02fb3b93b7eb0f2827125cb699869470432cc885f019b8fd0fccff77"}, - {file = "gitpython-3.1.45.tar.gz", hash = "sha256:85b0ee964ceddf211c41b9f27a49086010a190fd8132a24e21f362a4b36a791c"}, + {file = "gitpython-3.1.46-py3-none-any.whl", hash = "sha256:79812ed143d9d25b6d176a10bb511de0f9c67b1fa641d82097b0ab90398a2058"}, + {file = "gitpython-3.1.46.tar.gz", hash = "sha256:400124c7d0ef4ea03f7310ac2fbf7151e09ff97f2a3288d64a440c584a29c37f"}, ] [package.dependencies] @@ -495,7 +511,7 @@ gitdb = ">=4.0.1,<5" [package.extras] doc = ["sphinx (>=7.1.2,<7.2)", "sphinx-autodoc-typehints", "sphinx_rtd_theme"] -test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock ; python_version < \"3.8\"", "mypy", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions ; python_version < \"3.11\""] +test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock ; python_version < \"3.8\"", "mypy (==1.18.2) ; python_version >= \"3.9\"", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions ; python_version < \"3.11\""] [[package]] name = "idna" @@ -572,21 +588,21 @@ six = "*" [[package]] name = "jsonschema" -version = "4.25.1" +version = "4.26.0" description = "An implementation of JSON Schema validation for Python" optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["main"] files = [ - {file = "jsonschema-4.25.1-py3-none-any.whl", hash = "sha256:3fba0169e345c7175110351d456342c364814cfcf3b964ba4587f22915230a63"}, - {file = "jsonschema-4.25.1.tar.gz", hash = "sha256:e4a9655ce0da0c0b67a085847e00a3a51449e1157f4f75e9fb5aa545e122eb85"}, + {file = "jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce"}, + {file = "jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326"}, ] [package.dependencies] attrs = ">=22.2.0" jsonschema-specifications = ">=2023.3.6" referencing = ">=0.28.4" -rpds-py = ">=0.7.1" +rpds-py = ">=0.25.0" [package.extras] format = ["fqdn", "idna", "isoduration", "jsonpointer (>1.13)", "rfc3339-validator", "rfc3987", "uri-template", "webcolors (>=1.11)"] @@ -1032,26 +1048,26 @@ openapi-schema-validator = ">=0.6.0,<0.7.0" [[package]] name = "packaging" -version = "25.0" +version = "26.0" description = "Core utilities for Python packages" optional = false python-versions = ">=3.8" groups = ["main", "dev"] files = [ - {file = "packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484"}, - {file = "packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f"}, + {file = "packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529"}, + {file = "packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4"}, ] [[package]] name = "parse" -version = "1.20.2" +version = "1.21.1" description = "parse() is the opposite of format()" optional = false python-versions = "*" groups = ["main"] files = [ - {file = "parse-1.20.2-py2.py3-none-any.whl", hash = "sha256:967095588cb802add9177d0c0b6133b5ba33b1ea9007ca800e526f42a85af558"}, - {file = "parse-1.20.2.tar.gz", hash = "sha256:b41d604d16503c79d81af5165155c0b20f6c8d6c559efa66b4b695c3e5a0a0ce"}, + {file = "parse-1.21.1-py2.py3-none-any.whl", hash = "sha256:55339ca698019815df3b8e8b550e5933933527e623b0cdf1ca2f404da35ffb47"}, + {file = "parse-1.21.1.tar.gz", hash = "sha256:825e1a88e9d9fb481b8d2ca709c6195558b6eaa97c559ad3a9a20aa2d12815a3"}, ] [[package]] @@ -1086,39 +1102,34 @@ tests = ["pytest (>=9)", "typing-extensions (>=4.15)"] [[package]] name = "pip-licenses" -version = "5.5.0" +version = "5.5.5" description = "Dump the software license list of Python packages installed with pip." optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "pip_licenses-5.5.0-py3-none-any.whl", hash = "sha256:ae1869436d13ee487088d29e71fc5821950062ad25ec28b6a1a443e0add6d8e8"}, - {file = "pip_licenses-5.5.0.tar.gz", hash = "sha256:2473e7afd02a0c21460758f70fd2bb3b3c080c5150713dd33baa9493dc1563a5"}, + {file = "pip_licenses-5.5.5-py3-none-any.whl", hash = "sha256:f4c4c6d9e6a03612cf59f29f19dc8ab54904d82e055b8e191498f2279a224e14"}, + {file = "pip_licenses-5.5.5.tar.gz", hash = "sha256:60750c006adf7a0910347b726e8ee9fee3bc8d2e7c8307a5c4ec0776c8e2a276"}, ] [package.dependencies] prettytable = ">=3.12.0" [package.extras] -dev = ["autopep8", "black", "docutils", "isort", "mypy", "pip-tools", "pypandoc", "pytest-cov", "pytest-pycodestyle", "pytest-runner", "tomli-w", "twine", "wheel"] +dev = ["docutils (>=0.19)", "mypy", "pip-tools", "pypandoc", "pytest-cov", "pytest-runner", "ruff", "tomli-w", "virtualenv (>=21.1.0)", "wheel"] [[package]] name = "platformdirs" -version = "4.5.1" +version = "4.9.4" description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`." optional = false python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "platformdirs-4.5.1-py3-none-any.whl", hash = "sha256:d03afa3963c806a9bed9d5125c8f4cb2fdaf74a55ab60e5d59b3fde758104d31"}, - {file = "platformdirs-4.5.1.tar.gz", hash = "sha256:61d5cdcc6065745cdd94f0f878977f8de9437be93de97c1c12f853c9c0cdcbda"}, + {file = "platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868"}, + {file = "platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934"}, ] -[package.extras] -docs = ["furo (>=2025.9.25)", "proselint (>=0.14)", "sphinx (>=8.2.3)", "sphinx-autodoc-typehints (>=3.2)"] -test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=8.4.2)", "pytest-cov (>=7)", "pytest-mock (>=3.15.1)"] -type = ["mypy (>=1.18.2)"] - [[package]] name = "pluggy" version = "1.6.0" @@ -1179,15 +1190,15 @@ files = [ [[package]] name = "pycparser" -version = "2.23" +version = "3.0" description = "C parser in Python" optional = false -python-versions = ">=3.8" +python-versions = ">=3.10" groups = ["dev"] markers = "platform_python_implementation != \"PyPy\" and implementation_name != \"PyPy\"" files = [ - {file = "pycparser-2.23-py3-none-any.whl", hash = "sha256:e5c6e8d3fbad53479cab09ac03729e0a9faf2bee3db8208a550daf5af81a5934"}, - {file = "pycparser-2.23.tar.gz", hash = "sha256:78816d4f24add8f10a06d6f05b4d424ad9e96cfebf68a4ddc99c65c0720d00c2"}, + {file = "pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992"}, + {file = "pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29"}, ] [[package]] @@ -1399,14 +1410,14 @@ typing-extensions = ">=4.14.1" [[package]] name = "pydantic-settings" -version = "2.12.0" +version = "2.13.1" description = "Settings management using Pydantic" optional = false python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809"}, - {file = "pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0"}, + {file = "pydantic_settings-2.13.1-py3-none-any.whl", hash = "sha256:d56fd801823dbeae7f0975e1f8c8e25c258eb75d278ea7abb5d9cebb01b56237"}, + {file = "pydantic_settings-2.13.1.tar.gz", hash = "sha256:b4c11847b15237fb0171e1462bf540e294affb9b86db4d9aa5c01730bdbe4025"}, ] [package.dependencies] @@ -1435,14 +1446,14 @@ files = [ [[package]] name = "pygments" -version = "2.19.2" +version = "2.20.0" description = "Pygments is a syntax highlighting package written in Python." optional = false -python-versions = ">=3.8" +python-versions = ">=3.9" groups = ["main", "dev"] files = [ - {file = "pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b"}, - {file = "pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887"}, + {file = "pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176"}, + {file = "pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f"}, ] [package.extras] @@ -1524,14 +1535,14 @@ testing = ["coverage (>=6.2)", "hypothesis (>=5.7.1)"] [[package]] name = "pytest-check" -version = "2.6.2" +version = "2.8.0" description = "A pytest plugin that allows multiple failures per test." optional = false python-versions = ">=3.9" groups = ["main"] files = [ - {file = "pytest_check-2.6.2-py3-none-any.whl", hash = "sha256:71762eb58f6b8a2d75afb9e6c8b800af7f634f67359d899a65ee48aaee087215"}, - {file = "pytest_check-2.6.2.tar.gz", hash = "sha256:5e2128405b14978ad74f21f3225fcc52bbb1cc7c41a55d5eaad9f1e3cd27e42e"}, + {file = "pytest_check-2.8.0-py3-none-any.whl", hash = "sha256:671d94f857cebb4a4195baaf064ad77e3af8c37d0428dabdcfc3dcc992761634"}, + {file = "pytest_check-2.8.0.tar.gz", hash = "sha256:c42e08ddd41ad9c387bd16efa664ade5def4d7aa5c607b05ba9e25f5aaba70c2"}, ] [package.dependencies] @@ -1571,14 +1582,14 @@ wheel = ">=0.37.1,<0.45.0" [[package]] name = "python-dotenv" -version = "1.2.1" +version = "1.2.2" description = "Read key-value pairs from a .env file and set them as environment variables" optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61"}, - {file = "python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6"}, + {file = "python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a"}, + {file = "python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3"}, ] [package.extras] @@ -1740,25 +1751,26 @@ rpds-py = ">=0.7.0" [[package]] name = "requests" -version = "2.32.5" +version = "2.33.0" description = "Python HTTP for Humans." optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["main", "dev"] files = [ - {file = "requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6"}, - {file = "requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf"}, + {file = "requests-2.33.0-py3-none-any.whl", hash = "sha256:3324635456fa185245e24865e810cecec7b4caf933d7eb133dcde67d48cee69b"}, + {file = "requests-2.33.0.tar.gz", hash = "sha256:c7ebc5e8b0f21837386ad0e1c8fe8b829fa5f544d8df3b2253bff14ef29d7652"}, ] [package.dependencies] -certifi = ">=2017.4.17" +certifi = ">=2023.5.7" charset_normalizer = ">=2,<4" idna = ">=2.5,<4" -urllib3 = ">=1.21.1,<3" +urllib3 = ">=1.26,<3" [package.extras] socks = ["PySocks (>=1.5.6,!=1.5.7)"] -use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"] +test = ["PySocks (>=1.5.6,!=1.5.7)", "pytest (>=3)", "pytest-cov", "pytest-httpbin (==2.1.0)", "pytest-mock", "pytest-xdist"] +use-chardet-on-py3 = ["chardet (>=3.0.2,<8)"] [[package]] name = "rfc3339-validator" @@ -1947,14 +1959,14 @@ files = [ [[package]] name = "smmap" -version = "5.0.2" +version = "5.0.3" description = "A pure Python implementation of a sliding window memory map manager" optional = false python-versions = ">=3.7" groups = ["main"] files = [ - {file = "smmap-5.0.2-py3-none-any.whl", hash = "sha256:b30115f0def7d7531d22a0fb6502488d879e75b260a9db4d0819cfb25403af5e"}, - {file = "smmap-5.0.2.tar.gz", hash = "sha256:26ea65a03958fa0c8a1c7e8c7a58fdc77221b8910f6be2131affade476898ad5"}, + {file = "smmap-5.0.3-py3-none-any.whl", hash = "sha256:c106e05d5a61449cf6ba9a1e650227ecfb141590d2a98412103ff35d89fc7b2f"}, + {file = "smmap-5.0.3.tar.gz", hash = "sha256:4d9debb8b99007ae47165abc08670bd74cb74b5227dda7f643eccc4e9eb5642c"}, ] [[package]] @@ -2016,14 +2028,14 @@ zstd = ["backports-zstd (>=1.0.0) ; python_version < \"3.14\""] [[package]] name = "wcwidth" -version = "0.2.14" +version = "0.6.0" description = "Measures the displayed width of unicode strings in a terminal" optional = false -python-versions = ">=3.6" +python-versions = ">=3.8" groups = ["dev"] files = [ - {file = "wcwidth-0.2.14-py2.py3-none-any.whl", hash = "sha256:a7bb560c8aee30f9957e5f9895805edd20602f2d7f720186dfd906e82b4982e1"}, - {file = "wcwidth-0.2.14.tar.gz", hash = "sha256:4d478375d31bc5395a3c55c40ccdf3354688364cd61c4f6adacaa9215d0b3605"}, + {file = "wcwidth-0.6.0-py3-none-any.whl", hash = "sha256:1a3a1e510b553315f8e146c54764f4fb6264ffad731b3d78088cdb1478ffbdad"}, + {file = "wcwidth-0.6.0.tar.gz", hash = "sha256:cdc4e4262d6ef9a1a57e018384cbeb1208d8abbc64176027e2c2455c81313159"}, ] [[package]] @@ -2046,18 +2058,18 @@ watchdog = ["watchdog (>=2.3)"] [[package]] name = "wheel" -version = "0.38.4" +version = "0.44.0" description = "A built-package format for Python" optional = false -python-versions = ">=3.7" +python-versions = ">=3.8" groups = ["dev"] files = [ - {file = "wheel-0.38.4-py3-none-any.whl", hash = "sha256:b60533f3f5d530e971d6737ca6d58681ee434818fab630c83a734bb10c083ce8"}, - {file = "wheel-0.38.4.tar.gz", hash = "sha256:965f5259b566725405b05e7cf774052044b1ed30119b5d586b2703aafe8719ac"}, + {file = "wheel-0.44.0-py3-none-any.whl", hash = "sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f"}, + {file = "wheel-0.44.0.tar.gz", hash = "sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49"}, ] [package.extras] -test = ["pytest (>=3.0.0)"] +test = ["pytest (>=6.0.0)", "setuptools (>=65)"] [[package]] name = "xmlformatter" diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index 2b7cd17ac..84628f4d3 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -1,7 +1,7 @@ { "name": "e-referrals-service-api-sandbox", "version": "1.0.0", - "lockfileVersion": 2, + "lockfileVersion": 3, "requires": true, "packages": { "": { @@ -23,6 +23,7 @@ "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", "dev": true, + "license": "MIT", "dependencies": { "eslint-visitor-keys": "^3.4.3" }, @@ -36,44 +37,61 @@ "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0" } }, + "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": { + "version": "3.4.3", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", + "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": "^12.22.0 || ^14.17.0 || >=16.0.0" + }, + "funding": { + "url": "https://opencollective.com/eslint" + } + }, "node_modules/@eslint-community/regexpp": { "version": "4.12.2", "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", "dev": true, + "license": "MIT", "engines": { "node": "^12.0.0 || ^14.0.0 || >=16.0.0" } }, "node_modules/@eslint/config-array": { - "version": "0.20.1", - "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.20.1.tgz", - "integrity": "sha512-OL0RJzC/CBzli0DrrR31qzj6d6i6Mm3HByuhflhl4LOBiWxN+3i6/t/ZQQNii4tjksXi8r2CRW1wMpWA2ULUEw==", + "version": "0.21.2", + "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.21.2.tgz", + "integrity": "sha512-nJl2KGTlrf9GjLimgIru+V/mzgSK0ABCDQRvxw5BjURL7WfH5uoWmizbH7QB6MmnMBd8cIC9uceWnezL1VZWWw==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/object-schema": "^2.1.6", + "@eslint/object-schema": "^2.1.7", "debug": "^4.3.1", - "minimatch": "^3.1.2" + "minimatch": "^3.1.5" }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, "node_modules/@eslint/config-helpers": { - "version": "0.2.3", - "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.2.3.tgz", - "integrity": "sha512-u180qk2Um1le4yf0ruXH3PYFeEZeYC3p/4wCTKrr2U1CmGdzGi3KtY0nuPDH48UJxlKCC5RDzbcbh4X0XlqgHg==", + "version": "0.4.2", + "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.4.2.tgz", + "integrity": "sha512-gBrxN88gOIf3R7ja5K9slwNayVcZgK6SOUORm2uBzTeIEfeVaIhOpCtTox3P6R7o2jLFwLFTLnC7kU/RGcYEgw==", "dev": true, "license": "Apache-2.0", + "dependencies": { + "@eslint/core": "^0.17.0" + }, "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, "node_modules/@eslint/core": { - "version": "0.13.0", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.13.0.tgz", - "integrity": "sha512-yfkgDw1KR66rkT5A8ci4irzDysN7FRpq3ttJolR88OqQikAWqwA8j5VZyas+vjyBNFIJ7MfybJ9plMILI2UrCw==", + "version": "0.17.0", + "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.17.0.tgz", + "integrity": "sha512-yL/sLrpmtDaFEiUj1osRP4TI2MDz1AddJL+jZ7KSqvBuliN4xqYY54IfdN8qD8Toa6g1iloph1fxQNkjOxrrpQ==", "dev": true, "license": "Apache-2.0", "dependencies": { @@ -84,19 +102,20 @@ } }, "node_modules/@eslint/eslintrc": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", - "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", + "version": "3.3.5", + "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.5.tgz", + "integrity": "sha512-4IlJx0X0qftVsN5E+/vGujTRIFtwuLbNsVUe7TO6zYPDR1O6nFwvwhIKEKSrl6dZchmYBITazxKoUYOjdtjlRg==", "dev": true, + "license": "MIT", "dependencies": { - "ajv": "^6.12.4", + "ajv": "^6.14.0", "debug": "^4.3.2", "espree": "^10.0.1", "globals": "^14.0.0", "ignore": "^5.2.0", "import-fresh": "^3.2.1", "js-yaml": "^4.1.1", - "minimatch": "^3.1.2", + "minimatch": "^3.1.5", "strip-json-comments": "^3.1.1" }, "engines": { @@ -120,13 +139,16 @@ } }, "node_modules/@eslint/js": { - "version": "9.25.1", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.25.1.tgz", - "integrity": "sha512-dEIwmjntEx8u3Uvv+kr3PDeeArL8Hw07H9kyYxCjnM9pBjfEhk6uLXSchxxzgiwtRhhzVzqmUSDFBOi1TuZ7qg==", + "version": "9.39.4", + "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.39.4.tgz", + "integrity": "sha512-nE7DEIchvtiFTwBw4Lfbu59PG+kCofhjsKaCWzxTpt4lfRjRMqG6uMBzKXuEcyXhOHoUp9riAm7/aWYGhXZ9cw==", "dev": true, "license": "MIT", "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" + }, + "funding": { + "url": "https://eslint.org/donate" } }, "node_modules/@eslint/object-schema": { @@ -134,18 +156,19 @@ "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", "dev": true, + "license": "Apache-2.0", "engines": { "node": "^18.18.0 || ^20.9.0 || >=21.1.0" } }, "node_modules/@eslint/plugin-kit": { - "version": "0.2.8", - "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.2.8.tgz", - "integrity": "sha512-ZAoA40rNMPwSm+AeHpCq8STiNAwzWLJuP8Xv4CHIc9wv/PSuExjMrmjfYNj682vW0OOiZ1HKxzvjQr9XZIisQA==", + "version": "0.4.1", + "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.4.1.tgz", + "integrity": "sha512-43/qtrDUokr7LJqoF2c3+RInu/t4zfrpYdoSDfYyhg52rwLV6TnOvdG4fXm7IkSB3wErkcmJS9iEhjVtOSEjjA==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@eslint/core": "^0.13.0", + "@eslint/core": "^0.17.0", "levn": "^0.4.1" }, "engines": { @@ -156,6 +179,7 @@ "version": "6.0.3", "resolved": "https://registry.npmjs.org/@hapi/accept/-/accept-6.0.3.tgz", "integrity": "sha512-p72f9k56EuF0n3MwlBNThyVE5PXX40g+aQh+C/xbKrfzahM2Oispv3AXmOIU51t3j77zay1qrX7IIziZXspMlw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/hoek": "^11.0.2" @@ -165,6 +189,7 @@ "version": "6.0.1", "resolved": "https://registry.npmjs.org/@hapi/ammo/-/ammo-6.0.1.tgz", "integrity": "sha512-pmL+nPod4g58kXrMcsGLp05O2jF4P2Q3GiL8qYV7nKYEh3cGf+rV4P5Jyi2Uq0agGhVU63GtaSAfBEZOlrJn9w==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2" } @@ -173,6 +198,7 @@ "version": "6.0.1", "resolved": "https://registry.npmjs.org/@hapi/b64/-/b64-6.0.1.tgz", "integrity": "sha512-ZvjX4JQReUmBheeCq+S9YavcnMMHWqx3S0jHNXWIM1kQDxB9cyfSycpVvjfrKcIS8Mh5N3hmu/YKo4Iag9g2Kw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2" } @@ -181,6 +207,7 @@ "version": "10.0.1", "resolved": "https://registry.npmjs.org/@hapi/boom/-/boom-10.0.1.tgz", "integrity": "sha512-ERcCZaEjdH3OgSJlyjVk8pHIFeus91CjKP3v+MpgBNp5IvGzP2l/bRiD78nqYcKPaZdbKkK5vDBVPd2ohHBlsA==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2" } @@ -189,6 +216,7 @@ "version": "3.0.2", "resolved": "https://registry.npmjs.org/@hapi/bounce/-/bounce-3.0.2.tgz", "integrity": "sha512-d0XmlTi3H9HFDHhQLjg4F4auL1EY3Wqj7j7/hGDhFFe6xAbnm3qiGrXeT93zZnPH8gH+SKAFYiRzu26xkXcH3g==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/hoek": "^11.0.2" @@ -197,12 +225,14 @@ "node_modules/@hapi/bourne": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/@hapi/bourne/-/bourne-3.0.0.tgz", - "integrity": "sha512-Waj1cwPXJDucOib4a3bAISsKJVb15MKi9IvmTI/7ssVEm6sywXGjVJDhl6/umt1pK1ZS7PacXU3A1PmFKHEZ2w==" + "integrity": "sha512-Waj1cwPXJDucOib4a3bAISsKJVb15MKi9IvmTI/7ssVEm6sywXGjVJDhl6/umt1pK1ZS7PacXU3A1PmFKHEZ2w==", + "license": "BSD-3-Clause" }, "node_modules/@hapi/call": { "version": "9.0.1", "resolved": "https://registry.npmjs.org/@hapi/call/-/call-9.0.1.tgz", "integrity": "sha512-uPojQRqEL1GRZR4xXPqcLMujQGaEpyVPRyBlD8Pp5rqgIwLhtveF9PkixiKru2THXvuN8mUrLeet5fqxKAAMGg==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/hoek": "^11.0.2" @@ -212,6 +242,7 @@ "version": "12.1.1", "resolved": "https://registry.npmjs.org/@hapi/catbox/-/catbox-12.1.1.tgz", "integrity": "sha512-hDqYB1J+R0HtZg4iPH3LEnldoaBsar6bYp0EonBmNQ9t5CO+1CqgCul2ZtFveW1ReA5SQuze9GPSU7/aecERhw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/hoek": "^11.0.2", @@ -223,6 +254,7 @@ "version": "6.0.2", "resolved": "https://registry.npmjs.org/@hapi/catbox-memory/-/catbox-memory-6.0.2.tgz", "integrity": "sha512-H1l4ugoFW/ZRkqeFrIo8p1rWN0PA4MDTfu4JmcoNDvnY975o29mqoZblqFTotxNHlEkMPpIiIBJTV+Mbi+aF0g==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/hoek": "^11.0.2" @@ -232,6 +264,7 @@ "version": "6.0.0", "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.0.tgz", "integrity": "sha512-CEhs7j+H0iQffKfe5Htdak5LBOz/Qc8TRh51cF+BFv0qnuph3Em4pjGVzJMkI2gfTDdlJKWJISGWS1rK34POGA==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.0" } @@ -240,6 +273,7 @@ "version": "6.0.3", "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.3.tgz", "integrity": "sha512-r6VKalpbMHz4ci3gFjFysBmhwCg70RpYZy6OkjEpdXzAYnYFX5XsW7n4YMJvuIYpnMwLxGUjK/cBhA7X3JDvXw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1" }, @@ -250,12 +284,14 @@ "node_modules/@hapi/file": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/@hapi/file/-/file-3.0.0.tgz", - "integrity": "sha512-w+lKW+yRrLhJu620jT3y+5g2mHqnKfepreykvdOcl9/6up8GrQQn+l3FRTsjHTKbkbfQFkuksHpdv2EcpKcJ4Q==" + "integrity": "sha512-w+lKW+yRrLhJu620jT3y+5g2mHqnKfepreykvdOcl9/6up8GrQQn+l3FRTsjHTKbkbfQFkuksHpdv2EcpKcJ4Q==", + "license": "BSD-3-Clause" }, "node_modules/@hapi/hapi": { - "version": "21.4.4", - "resolved": "https://registry.npmjs.org/@hapi/hapi/-/hapi-21.4.4.tgz", - "integrity": "sha512-vI6JPLR99WZDKI1nriD0qXDPp8sKFkZfNVGrDDZafDQ8jU+3ERMwS0vPac5aGae6yyyoGZGOBiYExw4N8ScSTQ==", + "version": "21.4.7", + "resolved": "https://registry.npmjs.org/@hapi/hapi/-/hapi-21.4.7.tgz", + "integrity": "sha512-BNO7EgGdDPUaNGhkEiaW8xqk7IqzZNDljBPLcAZgyzpAKl72YR5sBlzfQG1ncrS7O1A7NPLHJkJJgd4YYHDHfg==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/accept": "^6.0.3", "@hapi/ammo": "^6.0.1", @@ -284,6 +320,7 @@ "version": "8.0.1", "resolved": "https://registry.npmjs.org/@hapi/heavy/-/heavy-8.0.1.tgz", "integrity": "sha512-gBD/NANosNCOp6RsYTsjo2vhr5eYA3BEuogk6cxY0QdhllkkTaJFYtTXv46xd6qhBVMbMMqcSdtqey+UQU3//w==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/hoek": "^11.0.2", @@ -293,12 +330,14 @@ "node_modules/@hapi/hoek": { "version": "11.0.7", "resolved": "https://registry.npmjs.org/@hapi/hoek/-/hoek-11.0.7.tgz", - "integrity": "sha512-HV5undWkKzcB4RZUusqOpcgxOaq6VOAH7zhhIr2g3G8NF/MlFO75SjOr2NfuSx0Mh40+1FqCkagKLJRykUWoFQ==" + "integrity": "sha512-HV5undWkKzcB4RZUusqOpcgxOaq6VOAH7zhhIr2g3G8NF/MlFO75SjOr2NfuSx0Mh40+1FqCkagKLJRykUWoFQ==", + "license": "BSD-3-Clause" }, "node_modules/@hapi/inert": { "version": "7.1.0", "resolved": "https://registry.npmjs.org/@hapi/inert/-/inert-7.1.0.tgz", "integrity": "sha512-5X+cl/Ozm0U9uPGGX1dSKhnhTQIf161bH/kkTN9OBVAZKFG+nrj8j/NMj6S1zBBZWmQrkVRNPfCUGrXzB4fCFQ==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/ammo": "^6.0.1", "@hapi/boom": "^10.0.1", @@ -308,18 +347,11 @@ "lru-cache": "^7.14.1" } }, - "node_modules/@hapi/inert/node_modules/lru-cache": { - "version": "7.18.3", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", - "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==", - "engines": { - "node": ">=12" - } - }, "node_modules/@hapi/iron": { "version": "7.0.1", "resolved": "https://registry.npmjs.org/@hapi/iron/-/iron-7.0.1.tgz", "integrity": "sha512-tEZnrOujKpS6jLKliyWBl3A9PaE+ppuL/+gkbyPPDb/l2KSKQyH4lhMkVb+sBhwN+qaxxlig01JRqB8dk/mPxQ==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/b64": "^6.0.1", "@hapi/boom": "^10.0.1", @@ -332,6 +364,7 @@ "version": "7.0.1", "resolved": "https://registry.npmjs.org/@hapi/mimos/-/mimos-7.0.1.tgz", "integrity": "sha512-b79V+BrG0gJ9zcRx1VGcCI6r6GEzzZUgiGEJVoq5gwzuB2Ig9Cax8dUuBauQCFKvl2YWSWyOc8mZ8HDaJOtkew==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2", "mime-db": "^1.52.0" @@ -341,6 +374,7 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/@hapi/nigel/-/nigel-5.0.1.tgz", "integrity": "sha512-uv3dtYuB4IsNaha+tigWmN8mQw/O9Qzl5U26Gm4ZcJVtDdB1AVJOwX3X5wOX+A07qzpEZnOMBAm8jjSqGsU6Nw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2", "@hapi/vise": "^5.0.1" @@ -353,6 +387,7 @@ "version": "6.1.0", "resolved": "https://registry.npmjs.org/@hapi/pez/-/pez-6.1.0.tgz", "integrity": "sha512-+FE3sFPYuXCpuVeHQ/Qag1b45clR2o54QoonE/gKHv9gukxQ8oJJZPR7o3/ydDTK6racnCJXxOyT1T93FCJMIg==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/b64": "^6.0.1", "@hapi/boom": "^10.0.1", @@ -365,6 +400,7 @@ "version": "5.0.2", "resolved": "https://registry.npmjs.org/@hapi/podium/-/podium-5.0.2.tgz", "integrity": "sha512-T7gf2JYHQQfEfewTQFbsaXoZxSvuXO/QBIGljucUQ/lmPnTTNAepoIKOakWNVWvo2fMEDjycu77r8k6dhreqHA==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2", "@hapi/teamwork": "^6.0.0", @@ -375,6 +411,7 @@ "version": "6.0.2", "resolved": "https://registry.npmjs.org/@hapi/shot/-/shot-6.0.2.tgz", "integrity": "sha512-WKK1ShfJTrL1oXC0skoIZQYzvLsyMDEF8lfcWuQBjpjCN29qivr9U36ld1z0nt6edvzv28etNMOqUF4klnHryw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2", "@hapi/validate": "^2.0.1" @@ -384,6 +421,7 @@ "version": "4.1.1", "resolved": "https://registry.npmjs.org/@hapi/somever/-/somever-4.1.1.tgz", "integrity": "sha512-lt3QQiDDOVRatS0ionFDNrDIv4eXz58IibQaZQDOg4DqqdNme8oa0iPWcE0+hkq/KTeBCPtEOjDOBKBKwDumVg==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/bounce": "^3.0.1", "@hapi/hoek": "^11.0.2" @@ -393,6 +431,7 @@ "version": "8.2.1", "resolved": "https://registry.npmjs.org/@hapi/statehood/-/statehood-8.2.1.tgz", "integrity": "sha512-xf72TG/QINW26jUu+uL5H+crE1o8GplIgfPWwPZhnAGJzetIVAQEQYvzq+C0aEVHg5/lMMtQ+L9UryuSa5Yjkg==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/bounce": "^3.0.1", @@ -407,6 +446,7 @@ "version": "8.1.1", "resolved": "https://registry.npmjs.org/@hapi/subtext/-/subtext-8.1.1.tgz", "integrity": "sha512-ex1Y2s/KuJktS8Ww0k6XJ5ysSKrzNym4i5pDVuCwlSgHHviHUsT1JNzE6FYhNU9TTHSNdyfue/t2m89bpkX9Jw==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/bourne": "^3.0.0", @@ -421,6 +461,7 @@ "version": "6.0.1", "resolved": "https://registry.npmjs.org/@hapi/teamwork/-/teamwork-6.0.1.tgz", "integrity": "sha512-52OXRslUfYwXAOG8k58f2h2ngXYQGP0x5RPOo+eWA/FtyLgHjGMrE3+e9LSXP/0q2YfHAK5wj9aA9DTy1K+kyQ==", + "license": "BSD-3-Clause", "engines": { "node": ">=14.0.0" } @@ -429,6 +470,7 @@ "version": "6.0.2", "resolved": "https://registry.npmjs.org/@hapi/topo/-/topo-6.0.2.tgz", "integrity": "sha512-KR3rD5inZbGMrHmgPxsJ9dbi6zEK+C3ZwUwTa+eMwWLz7oijWUTWD2pMSNNYJAU6Qq+65NkxXjqHr/7LM2Xkqg==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2" } @@ -437,6 +479,7 @@ "version": "2.0.1", "resolved": "https://registry.npmjs.org/@hapi/validate/-/validate-2.0.1.tgz", "integrity": "sha512-NZmXRnrSLK8MQ9y/CMqE9WSspgB9xA41/LlYR0k967aSZebWr4yNrpxIbov12ICwKy4APSlWXZga9jN5p6puPA==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2", "@hapi/topo": "^6.0.1" @@ -446,6 +489,7 @@ "version": "5.0.1", "resolved": "https://registry.npmjs.org/@hapi/vise/-/vise-5.0.1.tgz", "integrity": "sha512-XZYWzzRtINQLedPYlIkSkUr7m5Ddwlu99V9elh8CSygXstfv3UnWIXT0QD+wmR0VAG34d2Vx3olqcEhRRoTu9A==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/hoek": "^11.0.2" } @@ -454,6 +498,7 @@ "version": "18.1.0", "resolved": "https://registry.npmjs.org/@hapi/wreck/-/wreck-18.1.0.tgz", "integrity": "sha512-0z6ZRCmFEfV/MQqkQomJ7sl/hyxvcZM7LtuVqN3vdAO4vM9eBbowl0kaqQj9EJJQab+3Uuh1GxbGIBFy4NfJ4w==", + "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/bourne": "^3.0.0", @@ -475,6 +520,7 @@ "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", "dev": true, + "license": "Apache-2.0", "dependencies": { "@humanfs/core": "^0.19.1", "@humanwhocodes/retry": "^0.4.0" @@ -488,6 +534,7 @@ "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", "dev": true, + "license": "Apache-2.0", "engines": { "node": ">=12.22" }, @@ -501,6 +548,7 @@ "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", "dev": true, + "license": "Apache-2.0", "engines": { "node": ">=18.18" }, @@ -524,9 +572,9 @@ "license": "MIT" }, "node_modules/acorn": { - "version": "8.15.0", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", - "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", + "version": "8.16.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.16.0.tgz", + "integrity": "sha512-UVJyE9MttOsBQIDKw1skb9nAwQuR5wuGD3+82K6JgJlm/Y+KI92oNsMNGZCYdDsVtRHSak0pcV5Dno5+4jh9sw==", "dev": true, "license": "MIT", "bin": { @@ -547,9 +595,9 @@ } }, "node_modules/ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", + "version": "6.14.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz", + "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==", "dev": true, "license": "MIT", "dependencies": { @@ -563,6 +611,22 @@ "url": "https://github.com/sponsors/epoberezkin" } }, + "node_modules/ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^2.0.1" + }, + "engines": { + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", @@ -578,9 +642,9 @@ "license": "MIT" }, "node_modules/brace-expansion": { - "version": "1.1.12", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", - "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "version": "1.1.13", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.13.tgz", + "integrity": "sha512-9ZLprWS6EENmhEOpjCYW2c8VkmOvckIJZfkr7rBW6dObmfgJ/L1GpSYW5Hpo9lDz4D1+n0Ckz8rU7FwHDQiG/w==", "dev": true, "license": "MIT", "dependencies": { @@ -603,6 +667,7 @@ "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", "dev": true, + "license": "MIT", "dependencies": { "ansi-styles": "^4.1.0", "supports-color": "^7.1.0" @@ -614,26 +679,12 @@ "url": "https://github.com/chalk/chalk?sponsor=1" } }, - "node_modules/chalk/node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "dev": true, - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/chalk/node_modules/color-convert": { + "node_modules/color-convert": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", "dev": true, + "license": "MIT", "dependencies": { "color-name": "~1.1.4" }, @@ -641,32 +692,12 @@ "node": ">=7.0.0" } }, - "node_modules/chalk/node_modules/color-name": { + "node_modules/color-name": { "version": "1.1.4", "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true - }, - "node_modules/chalk/node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "dev": true, - "engines": { - "node": ">=8" - } - }, - "node_modules/chalk/node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", "dev": true, - "dependencies": { - "has-flag": "^4.0.0" - }, - "engines": { - "node": ">=8" - } + "license": "MIT" }, "node_modules/concat-map": { "version": "0.0.1", @@ -680,6 +711,7 @@ "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", "dev": true, + "license": "MIT", "dependencies": { "path-key": "^3.1.0", "shebang-command": "^2.0.0", @@ -694,6 +726,7 @@ "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", "dev": true, + "license": "MIT", "dependencies": { "ms": "^2.1.3" }, @@ -710,13 +743,15 @@ "version": "0.1.4", "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/escape-string-regexp": { "version": "4.0.0", "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -725,33 +760,32 @@ } }, "node_modules/eslint": { - "version": "9.25.1", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.25.1.tgz", - "integrity": "sha512-E6Mtz9oGQWDCpV12319d59n4tx9zOTXSTmc8BLVxBx+G/0RdM5MvEEJLU9c0+aleoePYYgVTOsRblx433qmhWQ==", + "version": "9.39.4", + "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.39.4.tgz", + "integrity": "sha512-XoMjdBOwe/esVgEvLmNsD3IRHkm7fbKIUGvrleloJXUZgDHig2IPWNniv+GwjyJXzuNqVjlr5+4yVUZjycJwfQ==", "dev": true, "license": "MIT", "dependencies": { - "@eslint-community/eslint-utils": "^4.2.0", + "@eslint-community/eslint-utils": "^4.8.0", "@eslint-community/regexpp": "^4.12.1", - "@eslint/config-array": "^0.20.0", - "@eslint/config-helpers": "^0.2.1", - "@eslint/core": "^0.13.0", - "@eslint/eslintrc": "^3.3.1", - "@eslint/js": "9.25.1", - "@eslint/plugin-kit": "^0.2.8", + "@eslint/config-array": "^0.21.2", + "@eslint/config-helpers": "^0.4.2", + "@eslint/core": "^0.17.0", + "@eslint/eslintrc": "^3.3.5", + "@eslint/js": "9.39.4", + "@eslint/plugin-kit": "^0.4.1", "@humanfs/node": "^0.16.6", "@humanwhocodes/module-importer": "^1.0.1", "@humanwhocodes/retry": "^0.4.2", "@types/estree": "^1.0.6", - "@types/json-schema": "^7.0.15", - "ajv": "^6.12.4", + "ajv": "^6.14.0", "chalk": "^4.0.0", "cross-spawn": "^7.0.6", "debug": "^4.3.2", "escape-string-regexp": "^4.0.0", - "eslint-scope": "^8.3.0", - "eslint-visitor-keys": "^4.2.0", - "espree": "^10.3.0", + "eslint-scope": "^8.4.0", + "eslint-visitor-keys": "^4.2.1", + "espree": "^10.4.0", "esquery": "^1.5.0", "esutils": "^2.0.2", "fast-deep-equal": "^3.1.3", @@ -763,7 +797,7 @@ "is-glob": "^4.0.0", "json-stable-stringify-without-jsonify": "^1.0.1", "lodash.merge": "^4.6.2", - "minimatch": "^3.1.2", + "minimatch": "^3.1.5", "natural-compare": "^1.4.0", "optionator": "^0.9.3" }, @@ -803,21 +837,9 @@ } }, "node_modules/eslint-visitor-keys": { - "version": "3.4.3", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", - "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", - "dev": true, - "engines": { - "node": "^12.22.0 || ^14.17.0 || >=16.0.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, - "node_modules/eslint/node_modules/eslint-visitor-keys": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.0.tgz", - "integrity": "sha512-UyLnSehNt62FFhSwjZlHmeokpRK59rcz29j+F1/aDgbkbRTk7wIc9XzdoasMUbRNKDM0qQt/+BJ4BrpFeABemw==", + "version": "4.2.1", + "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", + "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", "dev": true, "license": "Apache-2.0", "engines": { @@ -845,24 +867,12 @@ "url": "https://opencollective.com/eslint" } }, - "node_modules/espree/node_modules/eslint-visitor-keys": { - "version": "4.2.1", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", - "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", - "dev": true, - "license": "Apache-2.0", - "engines": { - "node": "^18.18.0 || ^20.9.0 || >=21.1.0" - }, - "funding": { - "url": "https://opencollective.com/eslint" - } - }, "node_modules/esquery": { "version": "1.7.0", "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "estraverse": "^5.1.0" }, @@ -888,6 +898,7 @@ "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", "dev": true, + "license": "BSD-2-Clause", "engines": { "node": ">=4.0" } @@ -920,7 +931,8 @@ "version": "2.0.6", "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/file-entry-cache": { "version": "8.0.0", @@ -940,6 +952,7 @@ "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", "dev": true, + "license": "MIT", "dependencies": { "locate-path": "^6.0.0", "path-exists": "^4.0.0" @@ -966,9 +979,9 @@ } }, "node_modules/flatted": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", - "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", + "version": "3.4.2", + "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.4.2.tgz", + "integrity": "sha512-PjDse7RzhcPkIJwy5t7KPWQSZ9cAbzQXcafsetQoD7sOJRQlGikNbx7yZp2OotDnJyrDcbyRq3Ttb18iYOqkxA==", "dev": true, "license": "ISC" }, @@ -977,6 +990,7 @@ "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", "dev": true, + "license": "ISC", "dependencies": { "is-glob": "^4.0.3" }, @@ -985,10 +999,11 @@ } }, "node_modules/globals": { - "version": "17.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz", - "integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==", + "version": "17.4.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-17.4.0.tgz", + "integrity": "sha512-hjrNztw/VajQwOLsMNT1cbJiH2muO3OROCHnbehc8eY5JyD2gqz4AcMHPqgaOR59DjgUjYAYLeH699g/eWi2jw==", "dev": true, + "license": "MIT", "engines": { "node": ">=18" }, @@ -996,6 +1011,16 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, "node_modules/ignore": { "version": "5.3.2", "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", @@ -1026,8 +1051,9 @@ "node_modules/imurmurhash": { "version": "0.1.4", "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", - "integrity": "sha1-khi5srkoojixPcT7a21XbyMUU+o=", + "integrity": "sha512-JmXMZ6wuvDmLiHEml9ykzqO6lwFbof0GG4IkcGaENdCRDDmMVnny7s5HsIgHCbaq0w2MyPhDqkhTUgS2LU2PHA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.8.19" } @@ -1037,6 +1063,7 @@ "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1046,6 +1073,7 @@ "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", "dev": true, + "license": "MIT", "dependencies": { "is-extglob": "^2.1.1" }, @@ -1056,14 +1084,16 @@ "node_modules/isexe": { "version": "2.0.0", "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=", - "dev": true + "integrity": "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw==", + "dev": true, + "license": "ISC" }, "node_modules/js-yaml": { "version": "4.1.1", "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", "dev": true, + "license": "MIT", "dependencies": { "argparse": "^2.0.1" }, @@ -1088,8 +1118,9 @@ "node_modules/json-stable-stringify-without-jsonify": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", - "integrity": "sha1-nbe1lJatPzz+8wp1FC0tkwrXJlE=", - "dev": true + "integrity": "sha512-Bdboy+l7tA3OGW6FjyFHWkP5LuByj1Tk33Ljyq0axyzdk9//JSi2u3fP1QSmd1KNwq6VOKYGlAu87CisVir6Pw==", + "dev": true, + "license": "MIT" }, "node_modules/keyv": { "version": "4.5.4", @@ -1106,6 +1137,7 @@ "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", "dev": true, + "license": "MIT", "dependencies": { "prelude-ls": "^1.2.1", "type-check": "~0.4.0" @@ -1119,6 +1151,7 @@ "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", "dev": true, + "license": "MIT", "dependencies": { "p-locate": "^5.0.0" }, @@ -1132,13 +1165,24 @@ "node_modules/lodash": { "version": "4.17.23", "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", - "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==" + "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==", + "license": "MIT" }, "node_modules/lodash.merge": { "version": "4.6.2", "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", - "dev": true + "dev": true, + "license": "MIT" + }, + "node_modules/lru-cache": { + "version": "7.18.3", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", + "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==", + "license": "ISC", + "engines": { + "node": ">=12" + } }, "node_modules/mime-db": { "version": "1.54.0", @@ -1154,6 +1198,7 @@ "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", "dev": true, + "license": "ISC", "dependencies": { "brace-expansion": "^1.1.7" }, @@ -1171,14 +1216,16 @@ "node_modules/natural-compare": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", - "integrity": "sha1-Sr6/7tdUHywnrPspvbvRXI1bpPc=", - "dev": true + "integrity": "sha512-OWND8ei3VtNC9h7V60qff3SVobHr996CTwgxubgyQYEpg290h9J0buyECNNJexkFm5sOajh5G116RYA1c8ZMSw==", + "dev": true, + "license": "MIT" }, "node_modules/optionator": { "version": "0.9.4", "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", "dev": true, + "license": "MIT", "dependencies": { "deep-is": "^0.1.3", "fast-levenshtein": "^2.0.6", @@ -1196,6 +1243,7 @@ "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", "dev": true, + "license": "MIT", "dependencies": { "yocto-queue": "^0.1.0" }, @@ -1211,6 +1259,7 @@ "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", "dev": true, + "license": "MIT", "dependencies": { "p-limit": "^3.0.2" }, @@ -1239,6 +1288,7 @@ "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1248,6 +1298,7 @@ "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1257,6 +1308,7 @@ "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.8.0" } @@ -1286,6 +1338,7 @@ "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", "dev": true, + "license": "MIT", "dependencies": { "shebang-regex": "^3.0.0" }, @@ -1298,6 +1351,7 @@ "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", "dev": true, + "license": "MIT", "engines": { "node": ">=8" } @@ -1315,11 +1369,25 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/type-check": { "version": "0.4.0", "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", "dev": true, + "license": "MIT", "dependencies": { "prelude-ls": "^1.2.1" }, @@ -1342,6 +1410,7 @@ "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", "dev": true, + "license": "ISC", "dependencies": { "isexe": "^2.0.0" }, @@ -1357,6 +1426,7 @@ "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1366,6 +1436,7 @@ "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", "dev": true, + "license": "MIT", "engines": { "node": ">=10" }, @@ -1373,1022 +1444,5 @@ "url": "https://github.com/sponsors/sindresorhus" } } - }, - "dependencies": { - "@eslint-community/eslint-utils": { - "version": "4.9.1", - "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.9.1.tgz", - "integrity": "sha512-phrYmNiYppR7znFEdqgfWHXR6NCkZEK7hwWDHZUjit/2/U0r6XvkDl0SYnoM51Hq7FhCGdLDT6zxCCOY1hexsQ==", - "dev": true, - "requires": { - "eslint-visitor-keys": "^3.4.3" - } - }, - "@eslint-community/regexpp": { - "version": "4.12.2", - "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz", - "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==", - "dev": true - }, - "@eslint/config-array": { - "version": "0.20.1", - "resolved": "https://registry.npmjs.org/@eslint/config-array/-/config-array-0.20.1.tgz", - "integrity": "sha512-OL0RJzC/CBzli0DrrR31qzj6d6i6Mm3HByuhflhl4LOBiWxN+3i6/t/ZQQNii4tjksXi8r2CRW1wMpWA2ULUEw==", - "dev": true, - "requires": { - "@eslint/object-schema": "^2.1.6", - "debug": "^4.3.1", - "minimatch": "^3.1.2" - } - }, - "@eslint/config-helpers": { - "version": "0.2.3", - "resolved": "https://registry.npmjs.org/@eslint/config-helpers/-/config-helpers-0.2.3.tgz", - "integrity": "sha512-u180qk2Um1le4yf0ruXH3PYFeEZeYC3p/4wCTKrr2U1CmGdzGi3KtY0nuPDH48UJxlKCC5RDzbcbh4X0XlqgHg==", - "dev": true - }, - "@eslint/core": { - "version": "0.13.0", - "resolved": "https://registry.npmjs.org/@eslint/core/-/core-0.13.0.tgz", - "integrity": "sha512-yfkgDw1KR66rkT5A8ci4irzDysN7FRpq3ttJolR88OqQikAWqwA8j5VZyas+vjyBNFIJ7MfybJ9plMILI2UrCw==", - "dev": true, - "requires": { - "@types/json-schema": "^7.0.15" - } - }, - "@eslint/eslintrc": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-3.3.3.tgz", - "integrity": "sha512-Kr+LPIUVKz2qkx1HAMH8q1q6azbqBAsXJUxBl/ODDuVPX45Z9DfwB8tPjTi6nNZ8BuM3nbJxC5zCAg5elnBUTQ==", - "dev": true, - "requires": { - "ajv": "^6.12.4", - "debug": "^4.3.2", - "espree": "^10.0.1", - "globals": "^14.0.0", - "ignore": "^5.2.0", - "import-fresh": "^3.2.1", - "js-yaml": "^4.1.1", - "minimatch": "^3.1.2", - "strip-json-comments": "^3.1.1" - }, - "dependencies": { - "globals": { - "version": "14.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-14.0.0.tgz", - "integrity": "sha512-oahGvuMGQlPw/ivIYBjVSrWAfWLBeku5tpPE2fOPLi+WHffIWbuh2tCjhyQhTBPMf5E9jDEH4FOmTYgYwbKwtQ==", - "dev": true - } - } - }, - "@eslint/js": { - "version": "9.25.1", - "resolved": "https://registry.npmjs.org/@eslint/js/-/js-9.25.1.tgz", - "integrity": "sha512-dEIwmjntEx8u3Uvv+kr3PDeeArL8Hw07H9kyYxCjnM9pBjfEhk6uLXSchxxzgiwtRhhzVzqmUSDFBOi1TuZ7qg==", - "dev": true - }, - "@eslint/object-schema": { - "version": "2.1.7", - "resolved": "https://registry.npmjs.org/@eslint/object-schema/-/object-schema-2.1.7.tgz", - "integrity": "sha512-VtAOaymWVfZcmZbp6E2mympDIHvyjXs/12LqWYjVw6qjrfF+VK+fyG33kChz3nnK+SU5/NeHOqrTEHS8sXO3OA==", - "dev": true - }, - "@eslint/plugin-kit": { - "version": "0.2.8", - "resolved": "https://registry.npmjs.org/@eslint/plugin-kit/-/plugin-kit-0.2.8.tgz", - "integrity": "sha512-ZAoA40rNMPwSm+AeHpCq8STiNAwzWLJuP8Xv4CHIc9wv/PSuExjMrmjfYNj682vW0OOiZ1HKxzvjQr9XZIisQA==", - "dev": true, - "requires": { - "@eslint/core": "^0.13.0", - "levn": "^0.4.1" - } - }, - "@hapi/accept": { - "version": "6.0.3", - "resolved": "https://registry.npmjs.org/@hapi/accept/-/accept-6.0.3.tgz", - "integrity": "sha512-p72f9k56EuF0n3MwlBNThyVE5PXX40g+aQh+C/xbKrfzahM2Oispv3AXmOIU51t3j77zay1qrX7IIziZXspMlw==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/ammo": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/@hapi/ammo/-/ammo-6.0.1.tgz", - "integrity": "sha512-pmL+nPod4g58kXrMcsGLp05O2jF4P2Q3GiL8qYV7nKYEh3cGf+rV4P5Jyi2Uq0agGhVU63GtaSAfBEZOlrJn9w==", - "requires": { - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/b64": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/@hapi/b64/-/b64-6.0.1.tgz", - "integrity": "sha512-ZvjX4JQReUmBheeCq+S9YavcnMMHWqx3S0jHNXWIM1kQDxB9cyfSycpVvjfrKcIS8Mh5N3hmu/YKo4Iag9g2Kw==", - "requires": { - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/boom": { - "version": "10.0.1", - "resolved": "https://registry.npmjs.org/@hapi/boom/-/boom-10.0.1.tgz", - "integrity": "sha512-ERcCZaEjdH3OgSJlyjVk8pHIFeus91CjKP3v+MpgBNp5IvGzP2l/bRiD78nqYcKPaZdbKkK5vDBVPd2ohHBlsA==", - "requires": { - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/bounce": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/@hapi/bounce/-/bounce-3.0.2.tgz", - "integrity": "sha512-d0XmlTi3H9HFDHhQLjg4F4auL1EY3Wqj7j7/hGDhFFe6xAbnm3qiGrXeT93zZnPH8gH+SKAFYiRzu26xkXcH3g==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/bourne": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/@hapi/bourne/-/bourne-3.0.0.tgz", - "integrity": "sha512-Waj1cwPXJDucOib4a3bAISsKJVb15MKi9IvmTI/7ssVEm6sywXGjVJDhl6/umt1pK1ZS7PacXU3A1PmFKHEZ2w==" - }, - "@hapi/call": { - "version": "9.0.1", - "resolved": "https://registry.npmjs.org/@hapi/call/-/call-9.0.1.tgz", - "integrity": "sha512-uPojQRqEL1GRZR4xXPqcLMujQGaEpyVPRyBlD8Pp5rqgIwLhtveF9PkixiKru2THXvuN8mUrLeet5fqxKAAMGg==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/catbox": { - "version": "12.1.1", - "resolved": "https://registry.npmjs.org/@hapi/catbox/-/catbox-12.1.1.tgz", - "integrity": "sha512-hDqYB1J+R0HtZg4iPH3LEnldoaBsar6bYp0EonBmNQ9t5CO+1CqgCul2ZtFveW1ReA5SQuze9GPSU7/aecERhw==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/hoek": "^11.0.2", - "@hapi/podium": "^5.0.0", - "@hapi/validate": "^2.0.1" - } - }, - "@hapi/catbox-memory": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/@hapi/catbox-memory/-/catbox-memory-6.0.2.tgz", - "integrity": "sha512-H1l4ugoFW/ZRkqeFrIo8p1rWN0PA4MDTfu4JmcoNDvnY975o29mqoZblqFTotxNHlEkMPpIiIBJTV+Mbi+aF0g==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/content": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.0.tgz", - "integrity": "sha512-CEhs7j+H0iQffKfe5Htdak5LBOz/Qc8TRh51cF+BFv0qnuph3Em4pjGVzJMkI2gfTDdlJKWJISGWS1rK34POGA==", - "requires": { - "@hapi/boom": "^10.0.0" - } - }, - "@hapi/cryptiles": { - "version": "6.0.3", - "resolved": "https://registry.npmjs.org/@hapi/cryptiles/-/cryptiles-6.0.3.tgz", - "integrity": "sha512-r6VKalpbMHz4ci3gFjFysBmhwCg70RpYZy6OkjEpdXzAYnYFX5XsW7n4YMJvuIYpnMwLxGUjK/cBhA7X3JDvXw==", - "requires": { - "@hapi/boom": "^10.0.1" - } - }, - "@hapi/file": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/@hapi/file/-/file-3.0.0.tgz", - "integrity": "sha512-w+lKW+yRrLhJu620jT3y+5g2mHqnKfepreykvdOcl9/6up8GrQQn+l3FRTsjHTKbkbfQFkuksHpdv2EcpKcJ4Q==" - }, - "@hapi/hapi": { - "version": "21.4.4", - "resolved": "https://registry.npmjs.org/@hapi/hapi/-/hapi-21.4.4.tgz", - "integrity": "sha512-vI6JPLR99WZDKI1nriD0qXDPp8sKFkZfNVGrDDZafDQ8jU+3ERMwS0vPac5aGae6yyyoGZGOBiYExw4N8ScSTQ==", - "requires": { - "@hapi/accept": "^6.0.3", - "@hapi/ammo": "^6.0.1", - "@hapi/boom": "^10.0.1", - "@hapi/bounce": "^3.0.2", - "@hapi/call": "^9.0.1", - "@hapi/catbox": "^12.1.1", - "@hapi/catbox-memory": "^6.0.2", - "@hapi/heavy": "^8.0.1", - "@hapi/hoek": "^11.0.7", - "@hapi/mimos": "^7.0.1", - "@hapi/podium": "^5.0.2", - "@hapi/shot": "^6.0.2", - "@hapi/somever": "^4.1.1", - "@hapi/statehood": "^8.2.1", - "@hapi/subtext": "^8.1.1", - "@hapi/teamwork": "^6.0.1", - "@hapi/topo": "^6.0.2", - "@hapi/validate": "^2.0.1" - } - }, - "@hapi/heavy": { - "version": "8.0.1", - "resolved": "https://registry.npmjs.org/@hapi/heavy/-/heavy-8.0.1.tgz", - "integrity": "sha512-gBD/NANosNCOp6RsYTsjo2vhr5eYA3BEuogk6cxY0QdhllkkTaJFYtTXv46xd6qhBVMbMMqcSdtqey+UQU3//w==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/hoek": "^11.0.2", - "@hapi/validate": "^2.0.1" - } - }, - "@hapi/hoek": { - "version": "11.0.7", - "resolved": "https://registry.npmjs.org/@hapi/hoek/-/hoek-11.0.7.tgz", - "integrity": "sha512-HV5undWkKzcB4RZUusqOpcgxOaq6VOAH7zhhIr2g3G8NF/MlFO75SjOr2NfuSx0Mh40+1FqCkagKLJRykUWoFQ==" - }, - "@hapi/inert": { - "version": "7.1.0", - "resolved": "https://registry.npmjs.org/@hapi/inert/-/inert-7.1.0.tgz", - "integrity": "sha512-5X+cl/Ozm0U9uPGGX1dSKhnhTQIf161bH/kkTN9OBVAZKFG+nrj8j/NMj6S1zBBZWmQrkVRNPfCUGrXzB4fCFQ==", - "requires": { - "@hapi/ammo": "^6.0.1", - "@hapi/boom": "^10.0.1", - "@hapi/bounce": "^3.0.1", - "@hapi/hoek": "^11.0.2", - "@hapi/validate": "^2.0.1", - "lru-cache": "^7.14.1" - }, - "dependencies": { - "lru-cache": { - "version": "7.18.3", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-7.18.3.tgz", - "integrity": "sha512-jumlc0BIUrS3qJGgIkWZsyfAM7NCWiBcCDhnd+3NNM5KbBmLTgHVfWBcg6W+rLUsIpzpERPsvwUP7CckAQSOoA==" - } - } - }, - "@hapi/iron": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/@hapi/iron/-/iron-7.0.1.tgz", - "integrity": "sha512-tEZnrOujKpS6jLKliyWBl3A9PaE+ppuL/+gkbyPPDb/l2KSKQyH4lhMkVb+sBhwN+qaxxlig01JRqB8dk/mPxQ==", - "requires": { - "@hapi/b64": "^6.0.1", - "@hapi/boom": "^10.0.1", - "@hapi/bourne": "^3.0.0", - "@hapi/cryptiles": "^6.0.1", - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/mimos": { - "version": "7.0.1", - "resolved": "https://registry.npmjs.org/@hapi/mimos/-/mimos-7.0.1.tgz", - "integrity": "sha512-b79V+BrG0gJ9zcRx1VGcCI6r6GEzzZUgiGEJVoq5gwzuB2Ig9Cax8dUuBauQCFKvl2YWSWyOc8mZ8HDaJOtkew==", - "requires": { - "@hapi/hoek": "^11.0.2", - "mime-db": "^1.52.0" - } - }, - "@hapi/nigel": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/@hapi/nigel/-/nigel-5.0.1.tgz", - "integrity": "sha512-uv3dtYuB4IsNaha+tigWmN8mQw/O9Qzl5U26Gm4ZcJVtDdB1AVJOwX3X5wOX+A07qzpEZnOMBAm8jjSqGsU6Nw==", - "requires": { - "@hapi/hoek": "^11.0.2", - "@hapi/vise": "^5.0.1" - } - }, - "@hapi/pez": { - "version": "6.1.0", - "resolved": "https://registry.npmjs.org/@hapi/pez/-/pez-6.1.0.tgz", - "integrity": "sha512-+FE3sFPYuXCpuVeHQ/Qag1b45clR2o54QoonE/gKHv9gukxQ8oJJZPR7o3/ydDTK6racnCJXxOyT1T93FCJMIg==", - "requires": { - "@hapi/b64": "^6.0.1", - "@hapi/boom": "^10.0.1", - "@hapi/content": "^6.0.0", - "@hapi/hoek": "^11.0.2", - "@hapi/nigel": "^5.0.1" - } - }, - "@hapi/podium": { - "version": "5.0.2", - "resolved": "https://registry.npmjs.org/@hapi/podium/-/podium-5.0.2.tgz", - "integrity": "sha512-T7gf2JYHQQfEfewTQFbsaXoZxSvuXO/QBIGljucUQ/lmPnTTNAepoIKOakWNVWvo2fMEDjycu77r8k6dhreqHA==", - "requires": { - "@hapi/hoek": "^11.0.2", - "@hapi/teamwork": "^6.0.0", - "@hapi/validate": "^2.0.1" - } - }, - "@hapi/shot": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/@hapi/shot/-/shot-6.0.2.tgz", - "integrity": "sha512-WKK1ShfJTrL1oXC0skoIZQYzvLsyMDEF8lfcWuQBjpjCN29qivr9U36ld1z0nt6edvzv28etNMOqUF4klnHryw==", - "requires": { - "@hapi/hoek": "^11.0.2", - "@hapi/validate": "^2.0.1" - } - }, - "@hapi/somever": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/@hapi/somever/-/somever-4.1.1.tgz", - "integrity": "sha512-lt3QQiDDOVRatS0ionFDNrDIv4eXz58IibQaZQDOg4DqqdNme8oa0iPWcE0+hkq/KTeBCPtEOjDOBKBKwDumVg==", - "requires": { - "@hapi/bounce": "^3.0.1", - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/statehood": { - "version": "8.2.1", - "resolved": "https://registry.npmjs.org/@hapi/statehood/-/statehood-8.2.1.tgz", - "integrity": "sha512-xf72TG/QINW26jUu+uL5H+crE1o8GplIgfPWwPZhnAGJzetIVAQEQYvzq+C0aEVHg5/lMMtQ+L9UryuSa5Yjkg==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/bounce": "^3.0.1", - "@hapi/bourne": "^3.0.0", - "@hapi/cryptiles": "^6.0.1", - "@hapi/hoek": "^11.0.2", - "@hapi/iron": "^7.0.1", - "@hapi/validate": "^2.0.1" - } - }, - "@hapi/subtext": { - "version": "8.1.1", - "resolved": "https://registry.npmjs.org/@hapi/subtext/-/subtext-8.1.1.tgz", - "integrity": "sha512-ex1Y2s/KuJktS8Ww0k6XJ5ysSKrzNym4i5pDVuCwlSgHHviHUsT1JNzE6FYhNU9TTHSNdyfue/t2m89bpkX9Jw==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/bourne": "^3.0.0", - "@hapi/content": "^6.0.0", - "@hapi/file": "^3.0.0", - "@hapi/hoek": "^11.0.2", - "@hapi/pez": "^6.1.0", - "@hapi/wreck": "^18.0.1" - } - }, - "@hapi/teamwork": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/@hapi/teamwork/-/teamwork-6.0.1.tgz", - "integrity": "sha512-52OXRslUfYwXAOG8k58f2h2ngXYQGP0x5RPOo+eWA/FtyLgHjGMrE3+e9LSXP/0q2YfHAK5wj9aA9DTy1K+kyQ==" - }, - "@hapi/topo": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/@hapi/topo/-/topo-6.0.2.tgz", - "integrity": "sha512-KR3rD5inZbGMrHmgPxsJ9dbi6zEK+C3ZwUwTa+eMwWLz7oijWUTWD2pMSNNYJAU6Qq+65NkxXjqHr/7LM2Xkqg==", - "requires": { - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/validate": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@hapi/validate/-/validate-2.0.1.tgz", - "integrity": "sha512-NZmXRnrSLK8MQ9y/CMqE9WSspgB9xA41/LlYR0k967aSZebWr4yNrpxIbov12ICwKy4APSlWXZga9jN5p6puPA==", - "requires": { - "@hapi/hoek": "^11.0.2", - "@hapi/topo": "^6.0.1" - } - }, - "@hapi/vise": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/@hapi/vise/-/vise-5.0.1.tgz", - "integrity": "sha512-XZYWzzRtINQLedPYlIkSkUr7m5Ddwlu99V9elh8CSygXstfv3UnWIXT0QD+wmR0VAG34d2Vx3olqcEhRRoTu9A==", - "requires": { - "@hapi/hoek": "^11.0.2" - } - }, - "@hapi/wreck": { - "version": "18.1.0", - "resolved": "https://registry.npmjs.org/@hapi/wreck/-/wreck-18.1.0.tgz", - "integrity": "sha512-0z6ZRCmFEfV/MQqkQomJ7sl/hyxvcZM7LtuVqN3vdAO4vM9eBbowl0kaqQj9EJJQab+3Uuh1GxbGIBFy4NfJ4w==", - "requires": { - "@hapi/boom": "^10.0.1", - "@hapi/bourne": "^3.0.0", - "@hapi/hoek": "^11.0.2" - } - }, - "@humanfs/core": { - "version": "0.19.1", - "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", - "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", - "dev": true - }, - "@humanfs/node": { - "version": "0.16.7", - "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", - "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", - "dev": true, - "requires": { - "@humanfs/core": "^0.19.1", - "@humanwhocodes/retry": "^0.4.0" - } - }, - "@humanwhocodes/module-importer": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", - "integrity": "sha512-bxveV4V8v5Yb4ncFTT3rPSgZBOpCkjfK0y4oVVVJwIuDVBRMDXrPyXRL988i5ap9m9bnyEEjWfm5WkBmtffLfA==", - "dev": true - }, - "@humanwhocodes/retry": { - "version": "0.4.3", - "resolved": "https://registry.npmjs.org/@humanwhocodes/retry/-/retry-0.4.3.tgz", - "integrity": "sha512-bV0Tgo9K4hfPCek+aMAn81RppFKv2ySDQeMoSZuvTASywNTnVJCArCZE2FWqpvIatKu7VMRLWlR1EazvVhDyhQ==", - "dev": true - }, - "@types/estree": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", - "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", - "dev": true - }, - "@types/json-schema": { - "version": "7.0.15", - "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", - "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==", - "dev": true - }, - "acorn": { - "version": "8.15.0", - "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.15.0.tgz", - "integrity": "sha512-NZyJarBfL7nWwIq+FDL6Zp/yHEhePMNnnJ0y3qfieCrmNvYct8uvtiV41UvlSe6apAfk0fY1FbWx+NwfmpvtTg==", - "dev": true - }, - "acorn-jsx": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/acorn-jsx/-/acorn-jsx-5.3.2.tgz", - "integrity": "sha512-rq9s+JNhf0IChjtDXxllJ7g41oZk5SlXtp0LHwyA5cejwn7vKmKp4pPri6YEePv2PU65sAsegbXtIinmDFDXgQ==", - "dev": true, - "requires": {} - }, - "ajv": { - "version": "6.12.6", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.12.6.tgz", - "integrity": "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g==", - "dev": true, - "requires": { - "fast-deep-equal": "^3.1.1", - "fast-json-stable-stringify": "^2.0.0", - "json-schema-traverse": "^0.4.1", - "uri-js": "^4.2.2" - } - }, - "argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", - "dev": true - }, - "balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", - "dev": true - }, - "brace-expansion": { - "version": "1.1.12", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", - "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", - "dev": true, - "requires": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" - } - }, - "callsites": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/callsites/-/callsites-3.1.0.tgz", - "integrity": "sha512-P8BjAsXvZS+VIDUI11hHCQEv74YT67YUi5JJFNWIqL235sBmjX4+qx9Muvls5ivyNENctx46xQLQ3aTuE7ssaQ==", - "dev": true - }, - "chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "dev": true, - "requires": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - }, - "dependencies": { - "ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "dev": true, - "requires": { - "color-convert": "^2.0.1" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "dev": true, - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "dev": true - }, - "has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "dev": true - }, - "supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "dev": true, - "requires": { - "has-flag": "^4.0.0" - } - } - } - }, - "concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", - "dev": true - }, - "cross-spawn": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/cross-spawn/-/cross-spawn-7.0.6.tgz", - "integrity": "sha512-uV2QOWP2nWzsy2aMp8aRibhi9dlzF5Hgh5SHaB9OiTGEyDTiJJyx0uy51QXdyWbtAHNua4XJzUKca3OzKUd3vA==", - "dev": true, - "requires": { - "path-key": "^3.1.0", - "shebang-command": "^2.0.0", - "which": "^2.0.1" - } - }, - "debug": { - "version": "4.4.3", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", - "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", - "dev": true, - "requires": { - "ms": "^2.1.3" - } - }, - "deep-is": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/deep-is/-/deep-is-0.1.4.tgz", - "integrity": "sha512-oIPzksmTg4/MriiaYGO+okXDT7ztn/w3Eptv/+gSIdMdKsJo0u4CfYNFJPy+4SKMuCqGw2wxnA+URMg3t8a/bQ==", - "dev": true - }, - "escape-string-regexp": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-4.0.0.tgz", - "integrity": "sha512-TtpcNJ3XAzx3Gq8sWRzJaVajRs0uVxA2YAkdb1jm2YkPz4G6egUFAyA3n5vtEIZefPk5Wa4UXbKuS5fKkJWdgA==", - "dev": true - }, - "eslint": { - "version": "9.25.1", - "resolved": "https://registry.npmjs.org/eslint/-/eslint-9.25.1.tgz", - "integrity": "sha512-E6Mtz9oGQWDCpV12319d59n4tx9zOTXSTmc8BLVxBx+G/0RdM5MvEEJLU9c0+aleoePYYgVTOsRblx433qmhWQ==", - "dev": true, - "requires": { - "@eslint-community/eslint-utils": "^4.2.0", - "@eslint-community/regexpp": "^4.12.1", - "@eslint/config-array": "^0.20.0", - "@eslint/config-helpers": "^0.2.1", - "@eslint/core": "^0.13.0", - "@eslint/eslintrc": "^3.3.1", - "@eslint/js": "9.25.1", - "@eslint/plugin-kit": "^0.2.8", - "@humanfs/node": "^0.16.6", - "@humanwhocodes/module-importer": "^1.0.1", - "@humanwhocodes/retry": "^0.4.2", - "@types/estree": "^1.0.6", - "@types/json-schema": "^7.0.15", - "ajv": "^6.12.4", - "chalk": "^4.0.0", - "cross-spawn": "^7.0.6", - "debug": "^4.3.2", - "escape-string-regexp": "^4.0.0", - "eslint-scope": "^8.3.0", - "eslint-visitor-keys": "^4.2.0", - "espree": "^10.3.0", - "esquery": "^1.5.0", - "esutils": "^2.0.2", - "fast-deep-equal": "^3.1.3", - "file-entry-cache": "^8.0.0", - "find-up": "^5.0.0", - "glob-parent": "^6.0.2", - "ignore": "^5.2.0", - "imurmurhash": "^0.1.4", - "is-glob": "^4.0.0", - "json-stable-stringify-without-jsonify": "^1.0.1", - "lodash.merge": "^4.6.2", - "minimatch": "^3.1.2", - "natural-compare": "^1.4.0", - "optionator": "^0.9.3" - }, - "dependencies": { - "eslint-visitor-keys": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.0.tgz", - "integrity": "sha512-UyLnSehNt62FFhSwjZlHmeokpRK59rcz29j+F1/aDgbkbRTk7wIc9XzdoasMUbRNKDM0qQt/+BJ4BrpFeABemw==", - "dev": true - } - } - }, - "eslint-scope": { - "version": "8.4.0", - "resolved": "https://registry.npmjs.org/eslint-scope/-/eslint-scope-8.4.0.tgz", - "integrity": "sha512-sNXOfKCn74rt8RICKMvJS7XKV/Xk9kA7DyJr8mJik3S7Cwgy3qlkkmyS2uQB3jiJg6VNdZd/pDBJu0nvG2NlTg==", - "dev": true, - "requires": { - "esrecurse": "^4.3.0", - "estraverse": "^5.2.0" - } - }, - "eslint-visitor-keys": { - "version": "3.4.3", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz", - "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==", - "dev": true - }, - "espree": { - "version": "10.4.0", - "resolved": "https://registry.npmjs.org/espree/-/espree-10.4.0.tgz", - "integrity": "sha512-j6PAQ2uUr79PZhBjP5C5fhl8e39FmRnOjsD5lGnWrFU8i2G776tBK7+nP8KuQUTTyAZUwfQqXAgrVH5MbH9CYQ==", - "dev": true, - "requires": { - "acorn": "^8.15.0", - "acorn-jsx": "^5.3.2", - "eslint-visitor-keys": "^4.2.1" - }, - "dependencies": { - "eslint-visitor-keys": { - "version": "4.2.1", - "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-4.2.1.tgz", - "integrity": "sha512-Uhdk5sfqcee/9H/rCOJikYz67o0a2Tw2hGRPOG2Y1R2dg7brRe1uG0yaNQDHu+TO/uQPF/5eCapvYSmHUjt7JQ==", - "dev": true - } - } - }, - "esquery": { - "version": "1.7.0", - "resolved": "https://registry.npmjs.org/esquery/-/esquery-1.7.0.tgz", - "integrity": "sha512-Ap6G0WQwcU/LHsvLwON1fAQX9Zp0A2Y6Y/cJBl9r/JbW90Zyg4/zbG6zzKa2OTALELarYHmKu0GhpM5EO+7T0g==", - "dev": true, - "requires": { - "estraverse": "^5.1.0" - } - }, - "esrecurse": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/esrecurse/-/esrecurse-4.3.0.tgz", - "integrity": "sha512-KmfKL3b6G+RXvP8N1vr3Tq1kL/oCFgn2NYXEtqP8/L3pKapUA4G8cFVaoF3SU323CD4XypR/ffioHmkti6/Tag==", - "dev": true, - "requires": { - "estraverse": "^5.2.0" - } - }, - "estraverse": { - "version": "5.3.0", - "resolved": "https://registry.npmjs.org/estraverse/-/estraverse-5.3.0.tgz", - "integrity": "sha512-MMdARuVEQziNTeJD8DgMqmhwR11BRQ/cBP+pLtYdSTnf3MIO8fFeiINEbX36ZdNlfU/7A9f3gUw49B3oQsvwBA==", - "dev": true - }, - "esutils": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/esutils/-/esutils-2.0.3.tgz", - "integrity": "sha512-kVscqXk4OCp68SZ0dkgEKVi6/8ij300KBWTJq32P/dYeWTSwK41WyTxalN1eRmA5Z9UU/LX9D7FWSmV9SAYx6g==", - "dev": true - }, - "fast-deep-equal": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", - "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==", - "dev": true - }, - "fast-json-stable-stringify": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", - "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==", - "dev": true - }, - "fast-levenshtein": { - "version": "2.0.6", - "resolved": "https://registry.npmjs.org/fast-levenshtein/-/fast-levenshtein-2.0.6.tgz", - "integrity": "sha512-DCXu6Ifhqcks7TZKY3Hxp3y6qphY5SJZmrWMDrKcERSOXWQdMhU9Ig/PYrzyw/ul9jOIyh0N4M0tbC5hodg8dw==", - "dev": true - }, - "file-entry-cache": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-8.0.0.tgz", - "integrity": "sha512-XXTUwCvisa5oacNGRP9SfNtYBNAMi+RPwBFmblZEF7N7swHYQS6/Zfk7SRwx4D5j3CH211YNRco1DEMNVfZCnQ==", - "dev": true, - "requires": { - "flat-cache": "^4.0.0" - } - }, - "find-up": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/find-up/-/find-up-5.0.0.tgz", - "integrity": "sha512-78/PXT1wlLLDgTzDs7sjq9hzz0vXD+zn+7wypEe4fXQxCmdmqfGsEPQxmiCSQI3ajFV91bVSsvNtrJRiW6nGng==", - "dev": true, - "requires": { - "locate-path": "^6.0.0", - "path-exists": "^4.0.0" - } - }, - "flat-cache": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/flat-cache/-/flat-cache-4.0.1.tgz", - "integrity": "sha512-f7ccFPK3SXFHpx15UIGyRJ/FJQctuKZ0zVuN3frBo4HnK3cay9VEW0R6yPYFHC0AgqhukPzKjq22t5DmAyqGyw==", - "dev": true, - "requires": { - "flatted": "^3.2.9", - "keyv": "^4.5.4" - } - }, - "flatted": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/flatted/-/flatted-3.3.3.tgz", - "integrity": "sha512-GX+ysw4PBCz0PzosHDepZGANEuFCMLrnRTiEy9McGjmkCQYwRq4A/X786G/fjM/+OjsWSU1ZrY5qyARZmO/uwg==", - "dev": true - }, - "glob-parent": { - "version": "6.0.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-6.0.2.tgz", - "integrity": "sha512-XxwI8EOhVQgWp6iDL+3b0r86f4d6AX6zSU55HfB4ydCEuXLXc5FcYeOu+nnGftS4TEju/11rt4KJPTMgbfmv4A==", - "dev": true, - "requires": { - "is-glob": "^4.0.3" - } - }, - "globals": { - "version": "17.0.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-17.0.0.tgz", - "integrity": "sha512-gv5BeD2EssA793rlFWVPMMCqefTlpusw6/2TbAVMy0FzcG8wKJn4O+NqJ4+XWmmwrayJgw5TzrmWjFgmz1XPqw==", - "dev": true - }, - "ignore": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", - "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", - "dev": true - }, - "import-fresh": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/import-fresh/-/import-fresh-3.3.1.tgz", - "integrity": "sha512-TR3KfrTZTYLPB6jUjfx6MF9WcWrHL9su5TObK4ZkYgBdWKPOFoSoQIdEuTuR82pmtxH2spWG9h6etwfr1pLBqQ==", - "dev": true, - "requires": { - "parent-module": "^1.0.0", - "resolve-from": "^4.0.0" - } - }, - "imurmurhash": { - "version": "0.1.4", - "resolved": "https://registry.npmjs.org/imurmurhash/-/imurmurhash-0.1.4.tgz", - "integrity": "sha1-khi5srkoojixPcT7a21XbyMUU+o=", - "dev": true - }, - "is-extglob": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", - "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", - "dev": true - }, - "is-glob": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", - "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", - "dev": true, - "requires": { - "is-extglob": "^2.1.1" - } - }, - "isexe": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/isexe/-/isexe-2.0.0.tgz", - "integrity": "sha1-6PvzdNxVb/iUehDcsFctYz8s+hA=", - "dev": true - }, - "js-yaml": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", - "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", - "dev": true, - "requires": { - "argparse": "^2.0.1" - } - }, - "json-buffer": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/json-buffer/-/json-buffer-3.0.1.tgz", - "integrity": "sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ==", - "dev": true - }, - "json-schema-traverse": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-0.4.1.tgz", - "integrity": "sha512-xbbCH5dCYU5T8LcEhhuh7HJ88HXuW3qsI3Y0zOZFKfZEHcpWiHU/Jxzk629Brsab/mMiHQti9wMP+845RPe3Vg==", - "dev": true - }, - "json-stable-stringify-without-jsonify": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/json-stable-stringify-without-jsonify/-/json-stable-stringify-without-jsonify-1.0.1.tgz", - "integrity": "sha1-nbe1lJatPzz+8wp1FC0tkwrXJlE=", - "dev": true - }, - "keyv": { - "version": "4.5.4", - "resolved": "https://registry.npmjs.org/keyv/-/keyv-4.5.4.tgz", - "integrity": "sha512-oxVHkHR/EJf2CNXnWxRLW6mg7JyCCUcG0DtEGmL2ctUo1PNTin1PUil+r/+4r5MpVgC/fn1kjsx7mjSujKqIpw==", - "dev": true, - "requires": { - "json-buffer": "3.0.1" - } - }, - "levn": { - "version": "0.4.1", - "resolved": "https://registry.npmjs.org/levn/-/levn-0.4.1.tgz", - "integrity": "sha512-+bT2uH4E5LGE7h/n3evcS/sQlJXCpIp6ym8OWJ5eV6+67Dsql/LaaT7qJBAt2rzfoa/5QBGBhxDix1dMt2kQKQ==", - "dev": true, - "requires": { - "prelude-ls": "^1.2.1", - "type-check": "~0.4.0" - } - }, - "locate-path": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/locate-path/-/locate-path-6.0.0.tgz", - "integrity": "sha512-iPZK6eYjbxRu3uB4/WZ3EsEIMJFMqAoopl3R+zuq0UjcAm/MO6KCweDgPfP3elTztoKP3KtnVHxTn2NHBSDVUw==", - "dev": true, - "requires": { - "p-locate": "^5.0.0" - } - }, - "lodash": { - "version": "4.17.23", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", - "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==" - }, - "lodash.merge": { - "version": "4.6.2", - "resolved": "https://registry.npmjs.org/lodash.merge/-/lodash.merge-4.6.2.tgz", - "integrity": "sha512-0KpjqXRVvrYyCsX1swR/XTK0va6VQkQM6MNo7PqW77ByjAhoARA8EfrP1N4+KlKj8YS0ZUCtRT/YUuhyYDujIQ==", - "dev": true - }, - "mime-db": { - "version": "1.54.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.54.0.tgz", - "integrity": "sha512-aU5EJuIN2WDemCcAp2vFBfp/m4EAhWJnUNSSw0ixs7/kXbd6Pg64EmwJkNdFhB8aWt1sH2CTXrLxo/iAGV3oPQ==" - }, - "minimatch": { - "version": "3.1.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", - "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", - "dev": true, - "requires": { - "brace-expansion": "^1.1.7" - } - }, - "ms": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", - "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", - "dev": true - }, - "natural-compare": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/natural-compare/-/natural-compare-1.4.0.tgz", - "integrity": "sha1-Sr6/7tdUHywnrPspvbvRXI1bpPc=", - "dev": true - }, - "optionator": { - "version": "0.9.4", - "resolved": "https://registry.npmjs.org/optionator/-/optionator-0.9.4.tgz", - "integrity": "sha512-6IpQ7mKUxRcZNLIObR0hz7lxsapSSIYNZJwXPGeF0mTVqGKFIXj1DQcMoT22S3ROcLyY/rz0PWaWZ9ayWmad9g==", - "dev": true, - "requires": { - "deep-is": "^0.1.3", - "fast-levenshtein": "^2.0.6", - "levn": "^0.4.1", - "prelude-ls": "^1.2.1", - "type-check": "^0.4.0", - "word-wrap": "^1.2.5" - } - }, - "p-limit": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/p-limit/-/p-limit-3.1.0.tgz", - "integrity": "sha512-TYOanM3wGwNGsZN2cVTYPArw454xnXj5qmWF1bEoAc4+cU/ol7GVh7odevjp1FNHduHc3KZMcFduxU5Xc6uJRQ==", - "dev": true, - "requires": { - "yocto-queue": "^0.1.0" - } - }, - "p-locate": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/p-locate/-/p-locate-5.0.0.tgz", - "integrity": "sha512-LaNjtRWUBY++zB5nE/NwcaoMylSPk+S+ZHNB1TzdbMJMny6dynpAGt7X/tl/QYq3TIeE6nxHppbo2LGymrG5Pw==", - "dev": true, - "requires": { - "p-limit": "^3.0.2" - } - }, - "parent-module": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/parent-module/-/parent-module-1.0.1.tgz", - "integrity": "sha512-GQ2EWRpQV8/o+Aw8YqtfZZPfNRWZYkbidE9k5rpl/hC3vtHHBfGm2Ifi6qWV+coDGkrUKZAxE3Lot5kcsRlh+g==", - "dev": true, - "requires": { - "callsites": "^3.0.0" - } - }, - "path-exists": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/path-exists/-/path-exists-4.0.0.tgz", - "integrity": "sha512-ak9Qy5Q7jYb2Wwcey5Fpvg2KoAc/ZIhLSLOSBmRmygPsGwkVVt0fZa0qrtMz+m6tJTAHfZQ8FnmB4MG4LWy7/w==", - "dev": true - }, - "path-key": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/path-key/-/path-key-3.1.1.tgz", - "integrity": "sha512-ojmeN0qd+y0jszEtoY48r0Peq5dwMEkIlCOu6Q5f41lfkswXuKtYrhgoTpLnyIcHm24Uhqx+5Tqm2InSwLhE6Q==", - "dev": true - }, - "prelude-ls": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/prelude-ls/-/prelude-ls-1.2.1.tgz", - "integrity": "sha512-vkcDPrRZo1QZLbn5RLGPpg/WmIQ65qoWWhcGKf/b5eplkkarX0m9z8ppCat4mlOqUsWpyNuYgO3VRyrYHSzX5g==", - "dev": true - }, - "punycode": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/punycode/-/punycode-2.3.1.tgz", - "integrity": "sha512-vYt7UD1U9Wg6138shLtLOvdAu+8DsC/ilFtEVHcH+wydcSpNE20AfSOduf6MkRFahL5FY7X1oU7nKVZFtfq8Fg==", - "dev": true - }, - "resolve-from": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/resolve-from/-/resolve-from-4.0.0.tgz", - "integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==", - "dev": true - }, - "shebang-command": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/shebang-command/-/shebang-command-2.0.0.tgz", - "integrity": "sha512-kHxr2zZpYtdmrN1qDjrrX/Z1rR1kG8Dx+gkpK1G4eXmvXswmcE1hTWBWYUzlraYw1/yZp6YuDY77YtvbN0dmDA==", - "dev": true, - "requires": { - "shebang-regex": "^3.0.0" - } - }, - "shebang-regex": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/shebang-regex/-/shebang-regex-3.0.0.tgz", - "integrity": "sha512-7++dFhtcx3353uBaq8DDR4NuxBetBzC7ZQOhmTQInHEd6bSrXdiEyzCvG07Z44UYdLShWUyXt5M/yhz8ekcb1A==", - "dev": true - }, - "strip-json-comments": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/strip-json-comments/-/strip-json-comments-3.1.1.tgz", - "integrity": "sha512-6fPc+R4ihwqP6N/aIv2f1gMH8lOVtWQHoqC4yK6oSDVVocumAsfCqjkXnqiYMhmMwS/mEHLp7Vehlt3ql6lEig==", - "dev": true - }, - "type-check": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz", - "integrity": "sha512-XleUoc9uwGXqjWwXaUTZAmzMcFZ5858QA2vvx1Ur5xIcixXIP+8LnFDgRplU30us6teqdlskFfu+ae4K79Ooew==", - "dev": true, - "requires": { - "prelude-ls": "^1.2.1" - } - }, - "uri-js": { - "version": "4.4.1", - "resolved": "https://registry.npmjs.org/uri-js/-/uri-js-4.4.1.tgz", - "integrity": "sha512-7rKUyy33Q1yc98pQ1DAmLtwX109F7TIfWlW1Ydo8Wl1ii1SeHieeh0HHfPeL2fMXK6z0s8ecKs9frCuLJvndBg==", - "dev": true, - "requires": { - "punycode": "^2.1.0" - } - }, - "which": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/which/-/which-2.0.2.tgz", - "integrity": "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA==", - "dev": true, - "requires": { - "isexe": "^2.0.0" - } - }, - "word-wrap": { - "version": "1.2.5", - "resolved": "https://registry.npmjs.org/word-wrap/-/word-wrap-1.2.5.tgz", - "integrity": "sha512-BN22B5eaMMI9UMtjrGd5g5eCYPpCPDUy0FJXbYsaT5zYxjFOckS53SQDE3pWkVoWpHXVb3BrYcEN4Twa55B5cA==", - "dev": true - }, - "yocto-queue": { - "version": "0.1.0", - "resolved": "https://registry.npmjs.org/yocto-queue/-/yocto-queue-0.1.0.tgz", - "integrity": "sha512-rVksvsnNCdJ/ohGc6xgPwyN8eheCxsiLM8mxuE/t/mOVqJewPuO1miLpTHQiRgTKCLexL4MeAFVagts7HmNZ2Q==", - "dev": true - } } } diff --git a/sandbox/python-deps.txt b/sandbox/python-deps.txt new file mode 100644 index 000000000..8877b58a7 --- /dev/null +++ b/sandbox/python-deps.txt @@ -0,0 +1,161 @@ +black 26.3.1 The uncompromising code formatter. +├── click >=8.0.0 +│ └── colorama * +├── mypy-extensions >=0.4.3 +├── packaging >=22.0 +├── pathspec >=1.0.0 +├── platformdirs >=2 +└── pytokens >=0.4.0,<0.5.0 +docopt 0.6.2 Pythonic argument parser, that will make you smile +flake8 7.3.0 the modular source code checker: pep8 pyflakes and co +├── mccabe >=0.7.0,<0.8.0 +├── pycodestyle >=2.14.0,<2.15.0 +└── pyflakes >=3.4.0,<3.5.0 +gitpython 3.1.45 GitPython is a Python library used to interact with Git repositories +└── gitdb >=4.0.1,<5 + └── smmap >=3.0.1,<6 +jinja2 3.1.6 A very fast and expressive template engine. +└── markupsafe >=2.0 +jsonpath-rw 1.4.0 A robust and significantly extended implementation of JSONPath for Python, with a clear AST for metaprogramming. +├── decorator * +├── ply * +└── six * +lxml 5.4.0 Powerful and Pythonic XML processing library combining libxml2/libxslt with the ElementTree API. +openapi-core 0.19.5 client-side and server-side support for the OpenAPI Specification v3 +├── isodate * +├── jsonschema >=4.18.0,<5.0.0 +│ ├── attrs >=22.2.0 +│ ├── jsonschema-specifications >=2023.3.6 +│ │ └── referencing >=0.31.0 +│ │ ├── attrs >=22.2.0 (circular dependency aborted here) +│ │ └── rpds-py >=0.7.0 +│ ├── referencing >=0.28.4 (circular dependency aborted here) +│ └── rpds-py >=0.7.1 (circular dependency aborted here) +├── jsonschema-path >=0.3.1,<0.4.0 +│ ├── pathable >=0.4.1,<0.5.0 +│ ├── pyyaml >=5.1 +│ ├── referencing <0.37.0 +│ │ ├── attrs >=22.2.0 +│ │ └── rpds-py >=0.7.0 +│ └── requests >=2.31.0,<3.0.0 +│ ├── certifi >=2017.4.17 +│ ├── charset-normalizer >=2,<4 +│ ├── idna >=2.5,<4 +│ └── urllib3 >=1.21.1,<3 +├── more-itertools * +├── openapi-schema-validator >=0.6.0,<0.7.0 +│ ├── jsonschema >=4.19.1,<5.0.0 +│ │ ├── attrs >=22.2.0 +│ │ ├── jsonschema-specifications >=2023.3.6 +│ │ │ └── referencing >=0.31.0 +│ │ │ ├── attrs >=22.2.0 (circular dependency aborted here) +│ │ │ └── rpds-py >=0.7.0 +│ │ ├── referencing >=0.28.4 (circular dependency aborted here) +│ │ └── rpds-py >=0.7.1 (circular dependency aborted here) +│ ├── jsonschema-specifications >=2023.5.2 (circular dependency aborted here) +│ └── rfc3339-validator * +│ └── six * +├── openapi-spec-validator >=0.7.1,<0.8.0 +│ ├── jsonschema >=4.18.0,<5.0.0 +│ │ ├── attrs >=22.2.0 +│ │ ├── jsonschema-specifications >=2023.3.6 +│ │ │ └── referencing >=0.31.0 +│ │ │ ├── attrs >=22.2.0 (circular dependency aborted here) +│ │ │ └── rpds-py >=0.7.0 +│ │ ├── referencing >=0.28.4 (circular dependency aborted here) +│ │ └── rpds-py >=0.7.1 (circular dependency aborted here) +│ ├── jsonschema-path >=0.3.1,<0.4.0 +│ │ ├── pathable >=0.4.1,<0.5.0 +│ │ ├── pyyaml >=5.1 +│ │ ├── referencing <0.37.0 (circular dependency aborted here) +│ │ └── requests >=2.31.0,<3.0.0 +│ │ ├── certifi >=2017.4.17 +│ │ ├── charset-normalizer >=2,<4 +│ │ ├── idna >=2.5,<4 +│ │ └── urllib3 >=1.21.1,<3 +│ ├── lazy-object-proxy >=1.7.1,<2.0.0 +│ └── openapi-schema-validator >=0.6.0,<0.7.0 +│ ├── jsonschema >=4.19.1,<5.0.0 (circular dependency aborted here) +│ ├── jsonschema-specifications >=2023.5.2 (circular dependency aborted here) +│ └── rfc3339-validator * +│ └── six * +├── parse * +├── typing-extensions >=4.8.0,<5.0.0 +└── werkzeug <3.1.2 + └── markupsafe >=2.1.1 +pip-licenses 5.5.0 Dump the software license list of Python packages installed with pip. +└── prettytable >=3.12.0 + └── wcwidth * +pytest 8.4.2 pytest: simple powerful testing with Python +├── colorama >=0.4 +├── iniconfig >=1 +├── packaging >=20 +├── pluggy >=1.5,<2 +└── pygments >=2.7.2 +pytest-asyncio 1.3.0 Pytest support for asyncio +└── pytest >=8.2,<10 + ├── colorama >=0.4 + ├── iniconfig >=1 + ├── packaging >=20 + ├── pluggy >=1.5,<2 + └── pygments >=2.7.2 +pytest-check 2.6.2 A pytest plugin that allows multiple failures per test. +└── pytest >=7.0.0 + ├── colorama >=0.4 + ├── iniconfig >=1 + ├── packaging >=20 + ├── pluggy >=1.5,<2 + └── pygments >=2.7.2 +pytest-nhsd-apim 5.0.15 Pytest plugin accessing NHSDigital's APIM proxies +├── authlib >=1.6.1,<2.0.0 +│ └── cryptography * +│ └── cffi >=2.0.0 +│ └── pycparser * +├── cryptography >44.0.1 +│ └── cffi >=2.0.0 +│ └── pycparser * +├── lxml >=5.3.1,<6.0.0 +├── pycryptodome >=3.20.0,<4.0.0 +├── pydantic >=2.9.2,<3.0.0 +│ ├── annotated-types >=0.6.0 +│ ├── pydantic-core 2.41.5 +│ │ └── typing-extensions >=4.14.1 +│ ├── typing-extensions >=4.14.1 (circular dependency aborted here) +│ └── typing-inspection >=0.4.2 +│ └── typing-extensions >=4.12.0 (circular dependency aborted here) +├── pydantic-settings >=2.2.1,<3.0.0 +│ ├── pydantic >=2.7.0 +│ │ ├── annotated-types >=0.6.0 +│ │ ├── pydantic-core 2.41.5 +│ │ │ └── typing-extensions >=4.14.1 +│ │ ├── typing-extensions >=4.14.1 (circular dependency aborted here) +│ │ └── typing-inspection >=0.4.2 +│ │ └── typing-extensions >=4.12.0 (circular dependency aborted here) +│ ├── python-dotenv >=0.21.0 +│ └── typing-inspection >=0.4.0 (circular dependency aborted here) +├── pyjwt >=2.8.0,<3.0.0 +├── pyotp >=2.9.0,<3.0.0 +├── pytest >=8.2.0,<9.0.0 +│ ├── colorama >=0.4 +│ ├── iniconfig >=1 +│ ├── packaging >=20 +│ ├── pluggy >=1.5,<2 +│ └── pygments >=2.7.2 +├── requests >=2.32.0,<3.0.0 +│ ├── certifi >=2017.4.17 +│ ├── charset-normalizer >=2,<4 +│ ├── idna >=2.5,<4 +│ └── urllib3 >=1.21.1,<3 +├── setuptools >=80.0.1,<81.0.0 +├── toml >=0.10.2,<0.11.0 +├── typing-extensions >=4.12.2,<5.0.0 +├── urllib3 >=2.6.1,<3.0.0 +└── wheel >=0.37.1,<0.45.0 +pyyaml 6.0.3 YAML parser and emitter for Python +requests 2.32.5 Python HTTP for Humans. +├── certifi >=2017.4.17 +├── charset-normalizer >=2,<4 +├── idna >=2.5,<4 +└── urllib3 >=1.21.1,<3 +semver 3.0.4 Python helper for Semantic Versioning (https://semver.org) +xmlformatter 0.2.8 Format and compress XML documents From fddf2dd407e7ad40dec5024e5cbf4a117f357fb3 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Mon, 30 Mar 2026 13:59:12 +0000 Subject: [PATCH 34/55] [RAA-6512]-[GC]-[Bumped Redocly (major) and override handlebars dep for dependabot]-[EW] --- package-lock.json | 2914 +- package.json | 5 +- redocly.yaml | 1 - .../a020-upload-file-to-document-store.yaml | 44 +- .../file/FileContentTypeSchemaDownload.yaml | 46 - .../file/FileContentTypeSchemaUpload.yaml | 43 - .../retrieveAttachment/200Response.yaml | 47 +- test-output.json | 100528 +++++++++++++++ 8 files changed, 101509 insertions(+), 2119 deletions(-) delete mode 100644 specification/components/stu3/schemas/file/FileContentTypeSchemaDownload.yaml delete mode 100644 specification/components/stu3/schemas/file/FileContentTypeSchemaUpload.yaml create mode 100644 test-output.json diff --git a/package-lock.json b/package-lock.json index 3a3becc57..236052a33 100644 --- a/package-lock.json +++ b/package-lock.json @@ -9,7 +9,7 @@ "version": "0.0.1", "license": "MIT", "dependencies": { - "@redocly/cli": "^1.34.5" + "@redocly/cli": "^2.25.3" }, "devDependencies": { "license-checker": "^25.0.1", @@ -40,9 +40,10 @@ } }, "node_modules/@babel/runtime": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.4.tgz", - "integrity": "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==", + "version": "7.29.2", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.2.tgz", + "integrity": "sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==", + "license": "MIT", "engines": { "node": ">=6.9.0" } @@ -93,278 +94,209 @@ "node": ">=10.10.0" } }, - "node_modules/@jest/schemas": { - "version": "29.6.3", - "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", - "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", - "license": "MIT", - "dependencies": { - "@sinclair/typebox": "^0.27.8" - }, - "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" - } - }, - "node_modules/@jsep-plugin/assignment": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/@jsep-plugin/assignment/-/assignment-1.3.0.tgz", - "integrity": "sha512-VVgV+CXrhbMI3aSusQyclHkenWSAm95WaiKrMxRFam3JSUiIaQjoMIw2sEs/OX4XifnqeQUN4DYbJjlA8EfktQ==", - "license": "MIT", - "engines": { - "node": ">= 10.16.0" - }, - "peerDependencies": { - "jsep": "^0.4.0||^1.0.0" - } - }, - "node_modules/@jsep-plugin/regex": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/@jsep-plugin/regex/-/regex-1.0.4.tgz", - "integrity": "sha512-q7qL4Mgjs1vByCaTnDFcBnV9HS7GVPJX5vyVoCgZHNSC9rjwIlmbXG5sUuorR5ndfHAIlJ8pVStxvjXHbNvtUg==", + "node_modules/@noble/hashes": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz", + "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==", "license": "MIT", "engines": { - "node": ">= 10.16.0" + "node": "^14.21.3 || >=16" }, - "peerDependencies": { - "jsep": "^0.4.0||^1.0.0" + "funding": { + "url": "https://paulmillr.com/funding/" } }, "node_modules/@opentelemetry/api": { - "version": "1.9.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.0.tgz", - "integrity": "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==", + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz", + "integrity": "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q==", "license": "Apache-2.0", "engines": { "node": ">=8.0.0" } }, "node_modules/@opentelemetry/api-logs": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.53.0.tgz", - "integrity": "sha512-8HArjKx+RaAI8uEIgcORbZIPklyh1YLjPSBus8hjRmvLi6DeFzgOcdZ7KwPabKj8mXF8dX0hyfAyGfycz0DbFw==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.202.0.tgz", + "integrity": "sha512-fTBjMqKCfotFWfLzaKyhjLvyEyq5vDKTTFfBmx21btv3gvy8Lq6N5Dh2OzqeuN4DjtpSvNT1uNVfg08eD2Rfxw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/api": "^1.0.0" + "@opentelemetry/api": "^1.3.0" }, "engines": { - "node": ">=14" + "node": ">=8.0.0" } }, "node_modules/@opentelemetry/context-async-hooks": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-1.26.0.tgz", - "integrity": "sha512-HedpXXYzzbaoutw6DFLWLDket2FwLkLpil4hGCZ1xYEIMTcivdfwEOISgdbLEWyG3HW52gTq2V9mOVJrONgiwg==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-2.0.1.tgz", + "integrity": "sha512-XuY23lSI3d4PEqKA+7SLtAgwqIfc6E/E9eAQWLN1vlpC53ybO3o6jW4BsXo1xvz9lYyyWItfQDDLzezER01mCw==", "license": "Apache-2.0", "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.0.0 <1.10.0" } }, "node_modules/@opentelemetry/core": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-1.26.0.tgz", - "integrity": "sha512-1iKxXXE8415Cdv0yjG3G6hQnB5eVEsJce3QaawX8SjDn0mAS0ZM8fAbZZJD4ajvhC15cePvosSCut404KrIIvQ==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/semantic-conventions": "1.27.0" + "@opentelemetry/semantic-conventions": "^1.29.0" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.0.0 <1.10.0" } }, "node_modules/@opentelemetry/exporter-trace-otlp-http": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.53.0.tgz", - "integrity": "sha512-m7F5ZTq+V9mKGWYpX8EnZ7NjoqAU7VemQ1E2HAG+W/u0wpY1x0OmbxAXfGKFHCspdJk8UKlwPGrpcB8nay3P8A==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.202.0.tgz", + "integrity": "sha512-/hKE8DaFCJuaQqE1IxpgkcjOolUIwgi3TgHElPVKGdGRBSmJMTmN/cr6vWa55pCJIXPyhKvcMrbrya7DZ3VmzA==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/otlp-exporter-base": "0.53.0", - "@opentelemetry/otlp-transformer": "0.53.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/sdk-trace-base": "1.26.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-exporter-base": "0.202.0", + "@opentelemetry/otlp-transformer": "0.202.0", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { - "@opentelemetry/api": "^1.0.0" + "@opentelemetry/api": "^1.3.0" } }, "node_modules/@opentelemetry/otlp-exporter-base": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.53.0.tgz", - "integrity": "sha512-UCWPreGQEhD6FjBaeDuXhiMf6kkBODF0ZQzrk/tuQcaVDJ+dDQ/xhJp192H9yWnKxVpEjFrSSLnpqmX4VwX+eA==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.202.0.tgz", + "integrity": "sha512-nMEOzel+pUFYuBJg2znGmHJWbmvMbdX5/RhoKNKowguMbURhz0fwik5tUKplLcUtl8wKPL1y9zPnPxeBn65N0Q==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/otlp-transformer": "0.53.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-transformer": "0.202.0" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { - "@opentelemetry/api": "^1.0.0" + "@opentelemetry/api": "^1.3.0" } }, "node_modules/@opentelemetry/otlp-transformer": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.53.0.tgz", - "integrity": "sha512-rM0sDA9HD8dluwuBxLetUmoqGJKSAbWenwD65KY9iZhUxdBHRLrIdrABfNDP7aiTjcgK8XFyTn5fhDz7N+W6DA==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.202.0.tgz", + "integrity": "sha512-5XO77QFzs9WkexvJQL9ksxL8oVFb/dfi9NWQSq7Sv0Efr9x3N+nb1iklP1TeVgxqJ7m1xWiC/Uv3wupiQGevMw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/api-logs": "0.53.0", - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/sdk-logs": "0.53.0", - "@opentelemetry/sdk-metrics": "1.26.0", - "@opentelemetry/sdk-trace-base": "1.26.0", + "@opentelemetry/api-logs": "0.202.0", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-logs": "0.202.0", + "@opentelemetry/sdk-metrics": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1", "protobufjs": "^7.3.0" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { "@opentelemetry/api": "^1.3.0" } }, - "node_modules/@opentelemetry/propagator-b3": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/propagator-b3/-/propagator-b3-1.26.0.tgz", - "integrity": "sha512-vvVkQLQ/lGGyEy9GT8uFnI047pajSOVnZI2poJqVGD3nJ+B9sFGdlHNnQKophE3lHfnIH0pw2ubrCTjZCgIj+Q==", - "license": "Apache-2.0", - "dependencies": { - "@opentelemetry/core": "1.26.0" - }, - "engines": { - "node": ">=14" - }, - "peerDependencies": { - "@opentelemetry/api": ">=1.0.0 <1.10.0" - } - }, - "node_modules/@opentelemetry/propagator-jaeger": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/propagator-jaeger/-/propagator-jaeger-1.26.0.tgz", - "integrity": "sha512-DelFGkCdaxA1C/QA0Xilszfr0t4YbGd3DjxiCDPh34lfnFr+VkkrjV9S8ZTJvAzfdKERXhfOxIKBoGPJwoSz7Q==", - "license": "Apache-2.0", - "dependencies": { - "@opentelemetry/core": "1.26.0" - }, - "engines": { - "node": ">=14" - }, - "peerDependencies": { - "@opentelemetry/api": ">=1.0.0 <1.10.0" - } - }, "node_modules/@opentelemetry/resources": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-1.26.0.tgz", - "integrity": "sha512-CPNYchBE7MBecCSVy0HKpUISEeJOniWqcHaAHpmasZ3j9o6V3AyBzhRc90jdmemq0HOxDr6ylhUbDhBqqPpeNw==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/semantic-conventions": "1.27.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { - "@opentelemetry/api": ">=1.0.0 <1.10.0" + "@opentelemetry/api": ">=1.3.0 <1.10.0" } }, "node_modules/@opentelemetry/sdk-logs": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.53.0.tgz", - "integrity": "sha512-dhSisnEgIj/vJZXZV6f6KcTnyLDx/VuQ6l3ejuZpMpPlh9S1qMHiZU9NMmOkVkwwHkMy3G6mEBwdP23vUZVr4g==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.202.0.tgz", + "integrity": "sha512-pv8QiQLQzk4X909YKm0lnW4hpuQg4zHwJ4XBd5bZiXcd9urvrJNoNVKnxGHPiDVX/GiLFvr5DMYsDBQbZCypRQ==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/api-logs": "0.53.0", - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0" + "@opentelemetry/api-logs": "0.202.0", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.4.0 <1.10.0" } }, "node_modules/@opentelemetry/sdk-metrics": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-1.26.0.tgz", - "integrity": "sha512-0SvDXmou/JjzSDOjUmetAAvcKQW6ZrvosU0rkbDGpXvvZN+pQF6JbK/Kd4hNdK4q/22yeruqvukXEJyySTzyTQ==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-2.0.1.tgz", + "integrity": "sha512-wf8OaJoSnujMAHWR3g+/hGvNcsC16rf9s1So4JlMiFaFHiE4HpIA3oUh+uWZQ7CNuK8gVW/pQSkgoa5HkkOl0g==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { - "@opentelemetry/api": ">=1.3.0 <1.10.0" + "@opentelemetry/api": ">=1.9.0 <1.10.0" } }, "node_modules/@opentelemetry/sdk-trace-base": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-1.26.0.tgz", - "integrity": "sha512-olWQldtvbK4v22ymrKLbIcBi9L2SpMO84sCPY54IVsJhP9fRsxJT194C/AVaAuJzLE30EdhhM1VmvVYR7az+cw==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", + "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/semantic-conventions": "1.27.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { - "@opentelemetry/api": ">=1.0.0 <1.10.0" + "@opentelemetry/api": ">=1.3.0 <1.10.0" } }, "node_modules/@opentelemetry/sdk-trace-node": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-1.26.0.tgz", - "integrity": "sha512-Fj5IVKrj0yeUwlewCRwzOVcr5avTuNnMHWf7GPc1t6WaT78J6CJyF3saZ/0RkZfdeNO8IcBl/bNcWMVZBMRW8Q==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-2.0.1.tgz", + "integrity": "sha512-UhdbPF19pMpBtCWYP5lHbTogLWx9N0EBxtdagvkn5YtsAnCBZzL7SjktG+ZmupRgifsHMjwUaCCaVmqGfSADmA==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/context-async-hooks": "1.26.0", - "@opentelemetry/core": "1.26.0", - "@opentelemetry/propagator-b3": "1.26.0", - "@opentelemetry/propagator-jaeger": "1.26.0", - "@opentelemetry/sdk-trace-base": "1.26.0", - "semver": "^7.5.2" + "@opentelemetry/context-async-hooks": "2.0.1", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1" }, "engines": { - "node": ">=14" + "node": "^18.19.0 || >=20.6.0" }, "peerDependencies": { "@opentelemetry/api": ">=1.0.0 <1.10.0" } }, - "node_modules/@opentelemetry/sdk-trace-node/node_modules/semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==", - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/@opentelemetry/semantic-conventions": { - "version": "1.27.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.27.0.tgz", - "integrity": "sha512-sAay1RrB+ONOem0OZanAR1ZI/k7yDpnOQSQmTMuGImUQb2y8EbSaCJ94FQluM74xoU03vlb2d2U90hZluL6nQg==", + "version": "1.34.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.34.0.tgz", + "integrity": "sha512-aKcOkyrorBGlajjRdVoJWHTxfxO1vCNHLJVlSDaRHDIdjU+pX8IYQPvPDkYiujKLbRnWU+1TBwEt0QRgSm4SGA==", "license": "Apache-2.0", "engines": { "node": ">=14" @@ -435,15 +367,15 @@ "license": "BSD-3-Clause" }, "node_modules/@redocly/ajv": { - "version": "8.11.2", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.11.2.tgz", - "integrity": "sha512-io1JpnwtIcvojV7QKDUSIuMN/ikdOUd1ReEnUnMKGfDVridQZ31J0MmIuqwuRjWDZfmvr+Q0MqCcfHM2gTivOg==", + "version": "8.18.1", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.1.tgz", + "integrity": "sha512-Ifm/pP/tul1qmAecpbVxCBluVE32rKfjf8gYXH4xI2gCv9mRWFhJMHzkPDM4TXlxwPQYIFegymlsy8lXz7optA==", "license": "MIT", "dependencies": { - "fast-deep-equal": "^3.1.1", + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", - "require-from-string": "^2.0.2", - "uri-js-replace": "^1.0.1" + "require-from-string": "^2.0.2" }, "funding": { "type": "github", @@ -451,36 +383,39 @@ } }, "node_modules/@redocly/cli": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-1.34.11.tgz", - "integrity": "sha512-NTFegt2uQ0A4xewDPcTadsZYSlmEUzF7wnvRgmFI8Ftvjpq/coIdr9EQPmCF6wjrh9UBKdz2rMNckxLo/jhViA==", - "license": "MIT", - "dependencies": { - "@opentelemetry/api": "1.9.0", - "@opentelemetry/exporter-trace-otlp-http": "0.53.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/sdk-trace-node": "1.26.0", - "@opentelemetry/semantic-conventions": "1.27.0", - "@redocly/config": "0.22.0", - "@redocly/openapi-core": "1.34.11", - "@redocly/respect-core": "1.34.11", - "abort-controller": "3.0.0", - "chokidar": "3.5.3", - "colorette": "1.4.0", - "core-js": "3.32.1", + "version": "2.25.3", + "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-2.25.3.tgz", + "integrity": "sha512-02wjApwJwGD+kGWRoiFVY0Hq960ydMAMHrK3AJH2LMiYNYcrzAr1FSbA3OSylvg2gx3w/r1r710B+iMz3KJKbw==", + "license": "MIT", + "dependencies": { + "@opentelemetry/exporter-trace-otlp-http": "0.202.0", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-trace-node": "2.0.1", + "@opentelemetry/semantic-conventions": "1.34.0", + "@redocly/cli-otel": "0.1.2", + "@redocly/openapi-core": "2.25.3", + "@redocly/respect-core": "2.25.3", + "abort-controller": "^3.0.0", + "ajv": "npm:@redocly/ajv@8.18.0", + "ajv-formats": "^3.0.1", + "colorette": "^1.2.0", + "cookie": "^0.7.2", "dotenv": "16.4.7", - "form-data": "4.0.4", - "get-port-please": "3.0.1", - "glob": "7.2.3", - "handlebars": "4.7.8", - "mobx": "6.12.3", - "pluralize": "8.0.0", + "glob": "^13.0.5", + "handlebars": "^4.7.6", + "https-proxy-agent": "^7.0.5", + "mobx": "^6.0.4", + "picomatch": "^4.0.4", + "pluralize": "^8.0.0", "react": "^17.0.0 || ^18.2.0 || ^19.2.1", "react-dom": "^17.0.0 || ^18.2.0 || ^19.2.1", - "redoc": "2.5.0", - "semver": "7.7.4", - "simple-websocket": "9.1.0", + "redoc": "2.5.1", + "semver": "^7.5.2", + "set-cookie-parser": "^2.3.5", + "simple-websocket": "^9.0.0", "styled-components": "6.3.9", + "ulid": "^3.0.1", + "undici": "6.24.0", "yargs": "17.0.1" }, "bin": { @@ -488,29 +423,79 @@ "redocly": "bin/cli.js" }, "engines": { - "node": ">=18.17.0", - "npm": ">=9.5.0" + "node": ">=22.12.0 || >=20.19.0 <21.0.0", + "npm": ">=10" } }, - "node_modules/@redocly/cli/node_modules/core-js": { - "version": "3.32.1", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.32.1.tgz", - "integrity": "sha512-lqufgNn9NLnESg5mQeYsxQP5w7wrViSj0jr/kv6ECQiByzQkrn1MKvV0L3acttpDqfQrHLwr2KCMgX5b8X+lyQ==", - "hasInstallScript": true, + "node_modules/@redocly/cli-otel": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/@redocly/cli-otel/-/cli-otel-0.1.2.tgz", + "integrity": "sha512-Bg7BoO5t1x3lVK+KhA5aGPmeXpQmdf6WtTYHhelKJCsQ+tRMiJoFAQoKHoBHAoNxXrhlS3K9lKFLHGmtxsFQfA==", "license": "MIT", - "funding": { - "type": "opencollective", - "url": "https://opencollective.com/core-js" + "dependencies": { + "ulid": "^2.3.0" + } + }, + "node_modules/@redocly/cli-otel/node_modules/ulid": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/ulid/-/ulid-2.4.0.tgz", + "integrity": "sha512-fIRiVTJNcSRmXKPZtGzFQv9WRrZ3M9eoptl/teFJvjOzmpU+/K/JH6HZ8deBfb5vMEpicJcLn7JmvdknlMq7Zg==", + "license": "MIT", + "bin": { + "ulid": "bin/cli.js" + } + }, + "node_modules/@redocly/cli/node_modules/balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" } }, - "node_modules/@redocly/cli/node_modules/mobx": { - "version": "6.12.3", - "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.12.3.tgz", - "integrity": "sha512-c8NKkO4R2lShkSXZ2Ongj1ycjugjzFFo/UswHBnS62y07DMcTc9Rvo03/3nRyszIvwPNljlkd4S828zIBv/piw==", + "node_modules/@redocly/cli/node_modules/brace-expansion": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz", + "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==", "license": "MIT", + "dependencies": { + "balanced-match": "^4.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + } + }, + "node_modules/@redocly/cli/node_modules/glob": { + "version": "13.0.6", + "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz", + "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", + "license": "BlueOak-1.0.0", + "dependencies": { + "minimatch": "^10.2.2", + "minipass": "^7.1.3", + "path-scurry": "^2.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, "funding": { - "type": "opencollective", - "url": "https://opencollective.com/mobx" + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/@redocly/cli/node_modules/minimatch": { + "version": "10.2.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz", + "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==", + "license": "BlueOak-1.0.0", + "dependencies": { + "brace-expansion": "^5.0.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" } }, "node_modules/@redocly/cli/node_modules/semver": { @@ -526,82 +511,58 @@ } }, "node_modules/@redocly/config": { - "version": "0.22.0", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", - "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==", - "license": "MIT" - }, - "node_modules/@redocly/openapi-core": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", - "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", - "license": "MIT", - "dependencies": { - "@redocly/ajv": "8.11.2", - "@redocly/config": "0.22.0", - "colorette": "1.4.0", - "https-proxy-agent": "7.0.6", - "js-levenshtein": "1.1.6", - "js-yaml": "4.1.1", - "minimatch": "5.1.9", - "pluralize": "8.0.0", - "yaml-ast-parser": "0.0.43" - }, - "engines": { - "node": ">=18.17.0", - "npm": ">=9.5.0" - } - }, - "node_modules/@redocly/openapi-core/node_modules/brace-expansion": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", - "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", + "version": "0.45.0", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.45.0.tgz", + "integrity": "sha512-V+wNusPQUaYV1c5s9iptfKQ2Ggno4bMeiyXdNILxqZS87gttwPfqlqHKHKFyz006voS3JsR295cbpx3GlsIxKg==", "license": "MIT", "dependencies": { - "balanced-match": "^1.0.0" + "json-schema-to-ts": "2.7.2" } }, - "node_modules/@redocly/openapi-core/node_modules/minimatch": { - "version": "5.1.9", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", - "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", - "license": "ISC", - "dependencies": { - "brace-expansion": "^2.0.1" + "node_modules/@redocly/openapi-core": { + "version": "2.25.3", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.25.3.tgz", + "integrity": "sha512-GIu3Mdym5IDIPCvXTzMZ6TQw/+7sKd52PdysxNVe7zBk22ExSGnVE9UAk9BaLOzXT77PJWDUwaimBdJoPpxHMA==", + "license": "MIT", + "dependencies": { + "@redocly/ajv": "^8.18.0", + "@redocly/config": "^0.45.0", + "ajv": "npm:@redocly/ajv@8.18.0", + "ajv-formats": "^3.0.1", + "colorette": "^1.2.0", + "js-levenshtein": "^1.1.6", + "js-yaml": "^4.1.0", + "picomatch": "^4.0.4", + "pluralize": "^8.0.0", + "yaml-ast-parser": "0.0.43" }, "engines": { - "node": ">=10" + "node": ">=22.12.0 || >=20.19.0 <21.0.0", + "npm": ">=10" } }, "node_modules/@redocly/respect-core": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-1.34.11.tgz", - "integrity": "sha512-0USZA1iRkyCZN/o5ZmgJ9vFVfWe5dE6m2IabF4g7s8EWJErbRFc8LoJ20hfoR75yGUfde+0vTPNOG5T9dlqq1g==", - "license": "MIT", - "dependencies": { - "@faker-js/faker": "7.6.0", - "@redocly/ajv": "8.11.2", - "@redocly/openapi-core": "1.34.11", - "better-ajv-errors": "1.2.0", - "colorette": "2.0.20", - "concat-stream": "2.0.0", - "cookie": "0.7.2", - "dotenv": "16.4.7", - "form-data": "4.0.4", - "jest-diff": "29.7.0", - "jest-matcher-utils": "29.7.0", - "js-yaml": "4.1.0", - "json-pointer": "0.6.2", - "jsonpath-plus": "10.3.0", - "open": "10.1.0", - "openapi-sampler": "1.7.0", - "outdent": "0.8.0", - "set-cookie-parser": "2.7.1", - "undici": "6.24.1" + "version": "2.25.3", + "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.25.3.tgz", + "integrity": "sha512-07m80JYdp7J7kH4D1Vqdpa2ZBFCv3QAwCoh2w9H3OjuT/rXQkBSkJQm1n70fzO/HuUf4azzULdp2XnsIpxP2qw==", + "license": "MIT", + "dependencies": { + "@faker-js/faker": "^7.6.0", + "@noble/hashes": "^1.8.0", + "@redocly/ajv": "^8.18.0", + "@redocly/openapi-core": "2.25.3", + "ajv": "npm:@redocly/ajv@8.18.0", + "better-ajv-errors": "^1.2.0", + "colorette": "^2.0.20", + "json-pointer": "^0.6.2", + "jsonpath-rfc9535": "1.3.0", + "openapi-sampler": "^1.7.1", + "outdent": "^0.8.0", + "picomatch": "^4.0.4" }, "engines": { - "node": ">=18.17.0", - "npm": ">=9.5.0" + "node": ">=22.12.0 || >=20.19.0 <21.0.0", + "npm": ">=10" } }, "node_modules/@redocly/respect-core/node_modules/colorette": { @@ -610,35 +571,6 @@ "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==", "license": "MIT" }, - "node_modules/@redocly/respect-core/node_modules/js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "license": "MIT", - "dependencies": { - "argparse": "^2.0.1" - }, - "bin": { - "js-yaml": "bin/js-yaml.js" - } - }, - "node_modules/@redocly/respect-core/node_modules/openapi-sampler": { - "version": "1.7.0", - "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.0.tgz", - "integrity": "sha512-fWq32F5vqGpgRJYIarC/9Y1wC9tKnRDcCOjsDJ7MIcSv2HsE7kNifcXIZ8FVtNStBUWxYrEk/MKqVF0SwZ5gog==", - "license": "MIT", - "dependencies": { - "@types/json-schema": "^7.0.7", - "fast-xml-parser": "^5.3.4", - "json-pointer": "0.6.2" - } - }, - "node_modules/@sinclair/typebox": { - "version": "0.27.10", - "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.10.tgz", - "integrity": "sha512-MTBk/3jGLNB2tVxv6uLlFh1iu64iYOQ2PbdOSK3NW8JZsmlaOh2q6sdtKowBhfw8QFLmYNzTW4/oK4uATIi6ZA==", - "license": "MIT" - }, "node_modules/@types/json-schema": { "version": "7.0.15", "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", @@ -646,9 +578,10 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "25.4.0", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.4.0.tgz", - "integrity": "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw==", + "version": "25.5.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.5.0.tgz", + "integrity": "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw==", + "license": "MIT", "dependencies": { "undici-types": "~7.18.0" } @@ -687,16 +620,17 @@ "version": "7.1.4", "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==", + "license": "MIT", "engines": { "node": ">= 14" } }, "node_modules/ajv": { + "name": "@redocly/ajv", "version": "8.18.0", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz", - "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.0.tgz", + "integrity": "sha512-F+LMD2IDIXuHxgpLJh3nkLj9+tSaEzoUWd+7fONGq5pe2169FUDjpEkOfEpoGLz1sbZni/69p07OsecNfAOpqA==", "license": "MIT", - "peer": true, "dependencies": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", @@ -708,6 +642,23 @@ "url": "https://github.com/sponsors/epoberezkin" } }, + "node_modules/ajv-formats": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", + "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", + "license": "MIT", + "dependencies": { + "ajv": "^8.0.0" + }, + "peerDependencies": { + "ajv": "^8.0.0" + }, + "peerDependenciesMeta": { + "ajv": { + "optional": true + } + } + }, "node_modules/ansi-regex": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", @@ -729,19 +680,6 @@ "node": ">=4" } }, - "node_modules/anymatch": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", - "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", - "license": "ISC", - "dependencies": { - "normalize-path": "^3.0.0", - "picomatch": "^2.0.4" - }, - "engines": { - "node": ">= 8" - } - }, "node_modules/argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", @@ -763,12 +701,6 @@ "integrity": "sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=", "dev": true }, - "node_modules/asynckit": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", - "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==", - "license": "MIT" - }, "node_modules/balanced-match": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", @@ -863,74 +795,17 @@ "node": ">=8" } }, - "node_modules/binary-extensions": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", - "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==", - "license": "MIT", - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/brace-expansion": { "version": "1.1.12", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, "license": "MIT", "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" } }, - "node_modules/braces": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", - "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", - "license": "MIT", - "dependencies": { - "fill-range": "^7.1.1" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/buffer-from": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", - "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==", - "license": "MIT" - }, - "node_modules/bundle-name": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz", - "integrity": "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==", - "license": "MIT", - "dependencies": { - "run-applescript": "^7.0.0" - }, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/call-bind-apply-helpers": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", - "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", - "license": "MIT", - "dependencies": { - "es-errors": "^1.3.0", - "function-bind": "^1.1.2" - }, - "engines": { - "node": ">= 0.4" - } - }, "node_modules/call-me-maybe": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", @@ -960,33 +835,6 @@ "node": ">=4" } }, - "node_modules/chokidar": { - "version": "3.5.3", - "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz", - "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==", - "funding": [ - { - "type": "individual", - "url": "https://paulmillr.com/funding/" - } - ], - "license": "MIT", - "dependencies": { - "anymatch": "~3.1.2", - "braces": "~3.0.2", - "glob-parent": "~5.1.2", - "is-binary-path": "~2.1.0", - "is-glob": "~4.0.1", - "normalize-path": "~3.0.0", - "readdirp": "~3.6.0" - }, - "engines": { - "node": ">= 8.10.0" - }, - "optionalDependencies": { - "fsevents": "~2.3.2" - } - }, "node_modules/classnames": { "version": "2.5.1", "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.5.1.tgz", @@ -1034,37 +882,11 @@ "integrity": "sha512-Y2oEozpomLn7Q3HFP7dpww7AtMJplbM9lGZP6RDfHqmbeRjiwRg4n6VM6j4KLmRke85uWEI7JqF17f3pqdRA0g==", "license": "MIT" }, - "node_modules/combined-stream": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", - "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", - "license": "MIT", - "dependencies": { - "delayed-stream": "~1.0.0" - }, - "engines": { - "node": ">= 0.8" - } - }, "node_modules/concat-map": { "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=" - }, - "node_modules/concat-stream": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz", - "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==", - "engines": [ - "node >= 6.0" - ], - "license": "MIT", - "dependencies": { - "buffer-from": "^1.0.0", - "inherits": "^2.0.3", - "readable-stream": "^3.0.2", - "typedarray": "^0.0.6" - } + "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", + "dev": true }, "node_modules/cookie": { "version": "0.7.2", @@ -1076,10 +898,11 @@ } }, "node_modules/core-js": { - "version": "3.48.0", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.48.0.tgz", - "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==", + "version": "3.49.0", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.49.0.tgz", + "integrity": "sha512-es1U2+YTtzpwkxVLwAFdSpaIMyQaq0PBgm3YD1W3Qpsn1NAmO3KSgZfu+oGSWVu6NvLHoHCV/aYcsE5wiB7ALg==", "hasInstallScript": true, + "license": "MIT", "peer": true, "funding": { "type": "opencollective", @@ -1142,55 +965,6 @@ "resolved": "https://registry.npmjs.org/decko/-/decko-1.2.0.tgz", "integrity": "sha512-m8FnyHXV1QX+S1cl+KPFDIl6NMkxtKsy6+U/aYyjrOqWMuwAwYWu7ePqrsUHtDR5Y8Yk2pi/KIDSgF+vT4cPOQ==" }, - "node_modules/default-browser": { - "version": "5.5.0", - "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz", - "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==", - "license": "MIT", - "dependencies": { - "bundle-name": "^4.1.0", - "default-browser-id": "^5.0.0" - }, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/default-browser-id": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", - "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==", - "license": "MIT", - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/define-lazy-prop": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz", - "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==", - "license": "MIT", - "engines": { - "node": ">=12" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/delayed-stream": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", - "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==", - "license": "MIT", - "engines": { - "node": ">=0.4.0" - } - }, "node_modules/dezalgo": { "version": "1.0.4", "resolved": "https://registry.npmjs.org/dezalgo/-/dezalgo-1.0.4.tgz", @@ -1201,22 +975,11 @@ "wrappy": "1" } }, - "node_modules/diff-sequences": { - "version": "29.6.3", - "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", - "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==", - "license": "MIT", - "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" - } - }, "node_modules/dompurify": { - "version": "3.3.2", - "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.2.tgz", - "integrity": "sha512-6obghkliLdmKa56xdbLOpUZ43pAR6xFy1uOrxBaIDjT+yaRuuybLjGS9eVBoSR/UPU5fq3OXClEHLJNGvbxKpQ==", - "engines": { - "node": ">=20" - }, + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.3.tgz", + "integrity": "sha512-Oj6pzI2+RqBfFG+qOaOLbFXLQ90ARpcGG6UePL82bJLtdsa6CYJD7nmiU8MW9nQNOtCHV3lZ/Bzq1X0QYbBZCA==", + "license": "(MPL-2.0 OR Apache-2.0)", "optionalDependencies": { "@types/trusted-types": "^2.0.7" } @@ -1233,71 +996,12 @@ "url": "https://dotenvx.com" } }, - "node_modules/dunder-proto": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", - "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", - "license": "MIT", - "dependencies": { - "call-bind-apply-helpers": "^1.0.1", - "es-errors": "^1.3.0", - "gopd": "^1.2.0" - }, - "engines": { - "node": ">= 0.4" - } - }, "node_modules/emoji-regex": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", "license": "MIT" }, - "node_modules/es-define-property": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", - "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==", - "license": "MIT", - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/es-errors": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", - "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", - "license": "MIT", - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/es-object-atoms": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", - "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", - "license": "MIT", - "dependencies": { - "es-errors": "^1.3.0" - }, - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/es-set-tostringtag": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", - "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", - "license": "MIT", - "dependencies": { - "es-errors": "^1.3.0", - "get-intrinsic": "^1.2.6", - "has-tostringtag": "^1.0.2", - "hasown": "^2.0.2" - }, - "engines": { - "node": ">= 0.4" - } - }, "node_modules/es6-promise": { "version": "3.3.1", "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.3.1.tgz", @@ -1331,9 +1035,9 @@ } }, "node_modules/eventemitter3": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz", - "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==", + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==", "license": "MIT" }, "node_modules/fast-deep-equal": { @@ -1362,8 +1066,7 @@ "url": "https://opencollective.com/fastify" } ], - "license": "BSD-3-Clause", - "peer": true + "license": "BSD-3-Clause" }, "node_modules/fast-xml-builder": { "version": "1.1.4", @@ -1400,63 +1103,23 @@ "fxparser": "src/cli/cli.js" } }, - "node_modules/fill-range": { - "version": "7.1.1", - "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", - "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", - "license": "MIT", - "dependencies": { - "to-regex-range": "^5.0.1" - }, - "engines": { - "node": ">=8" - } - }, "node_modules/foreach": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/foreach/-/foreach-2.0.6.tgz", "integrity": "sha512-k6GAGDyqLe9JaebCsFCoudPPWfihKu8pylYXRlqP1J7ms39iPoTtk2fviNglIeQEwdh0bQeKJ01ZPyuyQvKzwg==", "license": "MIT" }, - "node_modules/form-data": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz", - "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==", - "license": "MIT", - "dependencies": { - "asynckit": "^0.4.0", - "combined-stream": "^1.0.8", - "es-set-tostringtag": "^2.1.0", - "hasown": "^2.0.2", - "mime-types": "^2.1.12" - }, - "engines": { - "node": ">= 6" - } - }, "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=" - }, - "node_modules/fsevents": { - "version": "2.3.3", - "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", - "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", - "hasInstallScript": true, - "license": "MIT", - "optional": true, - "os": [ - "darwin" - ], - "engines": { - "node": "^8.16.0 || ^10.6.0 || >=11.0.0" - } + "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=", + "dev": true }, "node_modules/function-bind": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "dev": true, "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -1470,493 +1133,134 @@ "node": "6.* || 8.* || >= 10.*" } }, - "node_modules/get-intrinsic": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", - "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", - "license": "MIT", - "dependencies": { - "call-bind-apply-helpers": "^1.0.2", - "es-define-property": "^1.0.1", - "es-errors": "^1.3.0", - "es-object-atoms": "^1.1.1", - "function-bind": "^1.1.2", - "get-proto": "^1.0.1", - "gopd": "^1.2.0", - "has-symbols": "^1.1.0", - "hasown": "^2.0.2", - "math-intrinsics": "^1.1.0" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/get-port-please": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.0.1.tgz", - "integrity": "sha512-R5pcVO8Z1+pVDu8Ml3xaJCEkBiiy1VQN9za0YqH8GIi1nIqD4IzQhzY6dDzMRtdS1lyiGlucRzm8IN8wtLIXng==", - "license": "MIT" - }, - "node_modules/get-proto": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", - "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", - "license": "MIT", - "dependencies": { - "dunder-proto": "^1.0.1", - "es-object-atoms": "^1.0.0" - }, - "engines": { - "node": ">= 0.4" - } - }, "node_modules/glob": { "version": "7.2.3", "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", - "dependencies": { - "fs.realpath": "^1.0.0", - "inflight": "^1.0.4", - "inherits": "2", - "minimatch": "^3.1.1", - "once": "^1.3.0", - "path-is-absolute": "^1.0.0" - }, - "engines": { - "node": "*" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/glob-parent": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", - "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", - "license": "ISC", - "dependencies": { - "is-glob": "^4.0.1" - }, - "engines": { - "node": ">= 6" - } - }, - "node_modules/gopd": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", - "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==", - "license": "MIT", - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/graceful-fs": { - "version": "4.2.11", - "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", - "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "dev": true - }, - "node_modules/handlebars": { - "version": "4.7.8", - "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", - "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==", - "dependencies": { - "minimist": "^1.2.5", - "neo-async": "^2.6.2", - "source-map": "^0.6.1", - "wordwrap": "^1.0.0" - }, - "bin": { - "handlebars": "bin/handlebars" - }, - "engines": { - "node": ">=0.4.7" - }, - "optionalDependencies": { - "uglify-js": "^3.1.4" - } - }, - "node_modules/has-flag": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", - "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", "dev": true, - "engines": { - "node": ">=4" - } - }, - "node_modules/has-symbols": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", - "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==", - "license": "MIT", - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/has-tostringtag": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", - "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", - "license": "MIT", "dependencies": { - "has-symbols": "^1.0.3" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/hasown": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", - "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", - "dependencies": { - "function-bind": "^1.1.2" - }, - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/hosted-git-info": { - "version": "2.8.9", - "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", - "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true - }, - "node_modules/http2-client": { - "version": "1.3.5", - "resolved": "https://registry.npmjs.org/http2-client/-/http2-client-1.3.5.tgz", - "integrity": "sha512-EC2utToWl4RKfs5zd36Mxq7nzHHBuomZboI0yYL6Y0RmBgT7Sgkq4rQ0ezFTYoIsSs7Tm9SJe+o2FcAg6GBhGA==", - "license": "MIT" - }, - "node_modules/https-proxy-agent": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", - "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", - "license": "MIT", - "dependencies": { - "agent-base": "^7.1.2", - "debug": "4" - }, - "engines": { - "node": ">= 14" - } - }, - "node_modules/inflight": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", - "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=", - "dependencies": { - "once": "^1.3.0", - "wrappy": "1" - } - }, - "node_modules/inherits": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", - "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" - }, - "node_modules/is-binary-path": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", - "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", - "license": "MIT", - "dependencies": { - "binary-extensions": "^2.0.0" - }, - "engines": { - "node": ">=8" - } - }, - "node_modules/is-core-module": { - "version": "2.16.1", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", - "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", - "dev": true, - "dependencies": { - "hasown": "^2.0.2" - }, - "engines": { - "node": ">= 0.4" - }, - "funding": { - "url": "https://github.com/sponsors/ljharb" - } - }, - "node_modules/is-docker": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz", - "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==", - "license": "MIT", - "bin": { - "is-docker": "cli.js" - }, - "engines": { - "node": "^12.20.0 || ^14.13.1 || >=16.0.0" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/is-extglob": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", - "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/is-fullwidth-code-point": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", - "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/is-glob": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", - "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", - "license": "MIT", - "dependencies": { - "is-extglob": "^2.1.1" - }, - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/is-inside-container": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz", - "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==", - "license": "MIT", - "dependencies": { - "is-docker": "^3.0.0" - }, - "bin": { - "is-inside-container": "cli.js" - }, - "engines": { - "node": ">=14.16" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/is-number": { - "version": "7.0.0", - "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", - "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", - "license": "MIT", - "engines": { - "node": ">=0.12.0" - } - }, - "node_modules/is-wsl": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz", - "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==", - "license": "MIT", - "dependencies": { - "is-inside-container": "^1.0.0" - }, - "engines": { - "node": ">=16" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, - "node_modules/jest-diff": { - "version": "29.7.0", - "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", - "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", - "license": "MIT", - "dependencies": { - "chalk": "^4.0.0", - "diff-sequences": "^29.6.3", - "jest-get-type": "^29.6.3", - "pretty-format": "^29.7.0" - }, - "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" - } - }, - "node_modules/jest-diff/node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "license": "MIT", - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/jest-diff/node_modules/chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "license": "MIT", - "dependencies": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" }, "engines": { - "node": ">=10" + "node": "*" }, "funding": { - "url": "https://github.com/chalk/chalk?sponsor=1" + "url": "https://github.com/sponsors/isaacs" } }, - "node_modules/jest-diff/node_modules/color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "node_modules/graceful-fs": { + "version": "4.2.11", + "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", + "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", + "dev": true + }, + "node_modules/handlebars": { + "version": "4.7.9", + "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.9.tgz", + "integrity": "sha512-4E71E0rpOaQuJR2A3xDZ+GM1HyWYv1clR58tC8emQNeQe3RH7MAzSbat+V0wG78LQBo6m6bzSG/L4pBuCsgnUQ==", "license": "MIT", "dependencies": { - "color-name": "~1.1.4" + "minimist": "^1.2.5", + "neo-async": "^2.6.2", + "source-map": "^0.6.1", + "wordwrap": "^1.0.0" + }, + "bin": { + "handlebars": "bin/handlebars" }, "engines": { - "node": ">=7.0.0" + "node": ">=0.4.7" + }, + "optionalDependencies": { + "uglify-js": "^3.1.4" } }, - "node_modules/jest-diff/node_modules/color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "license": "MIT" - }, - "node_modules/jest-diff/node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "license": "MIT", + "node_modules/has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", + "dev": true, "engines": { - "node": ">=8" + "node": ">=4" } }, - "node_modules/jest-diff/node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "license": "MIT", + "node_modules/hasown": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", + "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "dev": true, "dependencies": { - "has-flag": "^4.0.0" + "function-bind": "^1.1.2" }, "engines": { - "node": ">=8" + "node": ">= 0.4" } }, - "node_modules/jest-get-type": { - "version": "29.6.3", - "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", - "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==", - "license": "MIT", - "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" - } + "node_modules/hosted-git-info": { + "version": "2.8.9", + "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", + "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", + "dev": true + }, + "node_modules/http2-client": { + "version": "1.3.5", + "resolved": "https://registry.npmjs.org/http2-client/-/http2-client-1.3.5.tgz", + "integrity": "sha512-EC2utToWl4RKfs5zd36Mxq7nzHHBuomZboI0yYL6Y0RmBgT7Sgkq4rQ0ezFTYoIsSs7Tm9SJe+o2FcAg6GBhGA==", + "license": "MIT" }, - "node_modules/jest-matcher-utils": { - "version": "29.7.0", - "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", - "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", + "node_modules/https-proxy-agent": { + "version": "7.0.6", + "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", + "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", "license": "MIT", "dependencies": { - "chalk": "^4.0.0", - "jest-diff": "^29.7.0", - "jest-get-type": "^29.6.3", - "pretty-format": "^29.7.0" + "agent-base": "^7.1.2", + "debug": "4" }, "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" + "node": ">= 14" } }, - "node_modules/jest-matcher-utils/node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "license": "MIT", + "node_modules/inflight": { + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", + "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=", + "dev": true, "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" + "once": "^1.3.0", + "wrappy": "1" } }, - "node_modules/jest-matcher-utils/node_modules/chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "license": "MIT", + "node_modules/inherits": { + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" + }, + "node_modules/is-core-module": { + "version": "2.16.1", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", + "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", + "dev": true, "dependencies": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" + "hasown": "^2.0.2" }, "engines": { - "node": ">=10" + "node": ">= 0.4" }, "funding": { - "url": "https://github.com/chalk/chalk?sponsor=1" - } - }, - "node_modules/jest-matcher-utils/node_modules/color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "license": "MIT", - "dependencies": { - "color-name": "~1.1.4" - }, - "engines": { - "node": ">=7.0.0" - } - }, - "node_modules/jest-matcher-utils/node_modules/color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "license": "MIT" - }, - "node_modules/jest-matcher-utils/node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "license": "MIT", - "engines": { - "node": ">=8" + "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/jest-matcher-utils/node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "node_modules/is-fullwidth-code-point": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", + "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==", "license": "MIT", - "dependencies": { - "has-flag": "^4.0.0" - }, "engines": { "node": ">=8" } @@ -1988,15 +1292,6 @@ "js-yaml": "bin/js-yaml.js" } }, - "node_modules/jsep": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/jsep/-/jsep-1.4.0.tgz", - "integrity": "sha512-B7qPcEVE3NVkmSJbaYxvv4cHkVW7DQsZz13pUMrfS8z8Q/BuShN+gcTXrUlPiGqM2/t/EEaI030bpxMqY8gMlw==", - "license": "MIT", - "engines": { - "node": ">= 10.16.0" - } - }, "node_modules/json-parse-even-better-errors": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", @@ -2012,28 +1307,33 @@ "foreach": "^2.0.4" } }, + "node_modules/json-schema-to-ts": { + "version": "2.7.2", + "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-2.7.2.tgz", + "integrity": "sha512-R1JfqKqbBR4qE8UyBR56Ms30LL62/nlhoz+1UkfI/VE7p54Awu919FZ6ZUPG8zIa3XB65usPJgr1ONVncUGSaQ==", + "license": "MIT", + "dependencies": { + "@babel/runtime": "^7.18.3", + "@types/json-schema": "^7.0.9", + "ts-algebra": "^1.2.0" + }, + "engines": { + "node": ">=16" + } + }, "node_modules/json-schema-traverse": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==", "license": "MIT" }, - "node_modules/jsonpath-plus": { - "version": "10.3.0", - "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-10.3.0.tgz", - "integrity": "sha512-8TNmfeTCk2Le33A3vRRwtuworG/L5RrgMvdjhKZxvyShO+mBu2fP50OWUjRLNtvw344DdDarFh9buFAZs5ujeA==", - "license": "MIT", - "dependencies": { - "@jsep-plugin/assignment": "^1.3.0", - "@jsep-plugin/regex": "^1.0.4", - "jsep": "^1.4.0" - }, - "bin": { - "jsonpath": "bin/jsonpath-cli.js", - "jsonpath-plus": "bin/jsonpath-cli.js" - }, + "node_modules/jsonpath-rfc9535": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/jsonpath-rfc9535/-/jsonpath-rfc9535-1.3.0.tgz", + "integrity": "sha512-3jFHya7oZ45aDxIIdx+/zQARahHXxFSMWBkcBUldfXpLS9VCXDJyTKt35kQfEXLqh0K3Ixw/9xFnvcDStaxh7Q==", + "license": "Apache-2.0", "engines": { - "node": ">=18.0.0" + "node": ">=20" } }, "node_modules/jsonpointer": { @@ -2102,6 +1402,15 @@ "loose-envify": "cli.js" } }, + "node_modules/lru-cache": { + "version": "11.2.7", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz", + "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==", + "license": "BlueOak-1.0.0", + "engines": { + "node": "20 || >=22" + } + }, "node_modules/lunr": { "version": "2.3.9", "resolved": "https://registry.npmjs.org/lunr/-/lunr-2.3.9.tgz", @@ -2126,40 +1435,11 @@ "node": ">= 12" } }, - "node_modules/math-intrinsics": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", - "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==", - "license": "MIT", - "engines": { - "node": ">= 0.4" - } - }, - "node_modules/mime-db": { - "version": "1.52.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", - "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==", - "license": "MIT", - "engines": { - "node": ">= 0.6" - } - }, - "node_modules/mime-types": { - "version": "2.1.35", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", - "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", - "license": "MIT", - "dependencies": { - "mime-db": "1.52.0" - }, - "engines": { - "node": ">= 0.6" - } - }, "node_modules/minimatch": { "version": "3.1.4", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.4.tgz", "integrity": "sha512-twmL+S8+7yIsE9wsqgzU3E8/LumN3M3QELrBZ20OdmQ9jB2JvW5oZtBEmft84k/Gs5CG9mqtWc6Y9vW+JEzGxw==", + "dev": true, "dependencies": { "brace-expansion": "^1.1.7" }, @@ -2175,6 +1455,15 @@ "url": "https://github.com/sponsors/ljharb" } }, + "node_modules/minipass": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz", + "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==", + "license": "BlueOak-1.0.0", + "engines": { + "node": ">=16 || 14 >=14.17" + } + }, "node_modules/mkdirp": { "version": "0.5.6", "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", @@ -2191,18 +1480,19 @@ "version": "6.15.0", "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.0.tgz", "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==", - "peer": true, + "license": "MIT", "funding": { "type": "opencollective", "url": "https://opencollective.com/mobx" } }, "node_modules/mobx-react": { - "version": "9.2.1", - "resolved": "https://registry.npmjs.org/mobx-react/-/mobx-react-9.2.1.tgz", - "integrity": "sha512-WJNNm0FB2n0Z0u+jS1QHmmWyV8l2WiAj8V8I/96kbUEN2YbYCoKW+hbbqKKRUBqElu0llxM7nWKehvRIkhBVJw==", + "version": "9.2.0", + "resolved": "https://registry.npmjs.org/mobx-react/-/mobx-react-9.2.0.tgz", + "integrity": "sha512-dkGWCx+S0/1mfiuFfHRH8D9cplmwhxOV5CkXMp38u6rQGG2Pv3FWYztS0M7ncR6TyPRQKaTG/pnitInoYE9Vrw==", + "license": "MIT", "dependencies": { - "mobx-react-lite": "^4.1.1" + "mobx-react-lite": "^4.1.0" }, "funding": { "type": "opencollective", @@ -2225,6 +1515,7 @@ "version": "4.1.1", "resolved": "https://registry.npmjs.org/mobx-react-lite/-/mobx-react-lite-4.1.1.tgz", "integrity": "sha512-iUxiMpsvNraCKXU+yPotsOncNNmyeS2B5DKL+TL6Tar/xm+wwNJAubJmtRSeAoYawdZqwv8Z/+5nPRHeQxTiXg==", + "license": "MIT", "dependencies": { "use-sync-external-store": "^1.4.0" }, @@ -2339,15 +1630,6 @@ "validate-npm-package-license": "^3.0.1" } }, - "node_modules/normalize-path": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", - "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==", - "license": "MIT", - "engines": { - "node": ">=0.10.0" - } - }, "node_modules/npm-normalize-package-bin": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-1.0.1.tgz", @@ -2437,32 +1719,16 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=", + "dev": true, "dependencies": { "wrappy": "1" } }, - "node_modules/open": { - "version": "10.1.0", - "resolved": "https://registry.npmjs.org/open/-/open-10.1.0.tgz", - "integrity": "sha512-mnkeQ1qP5Ue2wd+aivTD3NHd/lZ96Lu0jgf0pwktLPtx6cTZiH7tyeGRRHs0zX0rbrahXPnXlUnbeXyaBBuIaw==", - "license": "MIT", - "dependencies": { - "default-browser": "^5.2.1", - "define-lazy-prop": "^3.0.0", - "is-inside-container": "^1.0.0", - "is-wsl": "^3.1.0" - }, - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/openapi-sampler": { "version": "1.7.2", "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.2.tgz", "integrity": "sha512-OKytvqB5XIaTgA9xtw8W8UTar+uymW2xPVpFN0NihMtuHPdPTGxBEhGnfFnJW5g/gOSIvkP+H0Xh3XhVI9/n7g==", + "license": "MIT", "dependencies": { "@types/json-schema": "^7.0.7", "fast-xml-parser": "^5.5.1", @@ -2528,6 +1794,7 @@ "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=", + "dev": true, "engines": { "node": ">=0.10.0" } @@ -2538,6 +1805,22 @@ "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", "dev": true }, + "node_modules/path-scurry": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz", + "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==", + "license": "BlueOak-1.0.0", + "dependencies": { + "lru-cache": "^11.0.0", + "minipass": "^7.1.2" + }, + "engines": { + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, "node_modules/perfect-scrollbar": { "version": "1.5.6", "resolved": "https://registry.npmjs.org/perfect-scrollbar/-/perfect-scrollbar-1.5.6.tgz", @@ -2551,12 +1834,12 @@ "license": "ISC" }, "node_modules/picomatch": { - "version": "2.3.2", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", - "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==", + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==", "license": "MIT", "engines": { - "node": ">=8.6" + "node": ">=12" }, "funding": { "url": "https://github.com/sponsors/jonschlinkert" @@ -2617,32 +1900,6 @@ "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==", "license": "MIT" }, - "node_modules/pretty-format": { - "version": "29.7.0", - "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", - "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", - "license": "MIT", - "dependencies": { - "@jest/schemas": "^29.6.3", - "ansi-styles": "^5.0.0", - "react-is": "^18.0.0" - }, - "engines": { - "node": "^14.15.0 || ^16.10.0 || >=18.0.0" - } - }, - "node_modules/pretty-format/node_modules/ansi-styles": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", - "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==", - "license": "MIT", - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, "node_modules/prismjs": { "version": "1.30.0", "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", @@ -2658,22 +1915,17 @@ "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==", "license": "MIT", "dependencies": { - "loose-envify": "^1.4.0", - "object-assign": "^4.1.1", - "react-is": "^16.13.1" - } - }, - "node_modules/prop-types/node_modules/react-is": { - "version": "16.13.1", - "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", - "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==", - "license": "MIT" + "loose-envify": "^1.4.0", + "object-assign": "^4.1.1", + "react-is": "^16.13.1" + } }, "node_modules/protobufjs": { "version": "7.5.4", "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz", "integrity": "sha512-CvexbZtbov6jW2eXAvLukXjXUW1TzFaivC46BpWc/3BpcCysb5Vffu+B3XHMm8lVEuy2Mm4XGex8hBSg1yapPg==", "hasInstallScript": true, + "license": "BSD-3-Clause", "dependencies": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", @@ -2723,6 +1975,7 @@ "version": "19.2.4", "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==", + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -2731,6 +1984,7 @@ "version": "19.2.4", "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", + "license": "MIT", "dependencies": { "scheduler": "^0.27.0" }, @@ -2739,15 +1993,15 @@ } }, "node_modules/react-is": { - "version": "18.3.1", - "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", - "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==", + "version": "16.13.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", + "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==", "license": "MIT" }, "node_modules/react-tabs": { - "version": "6.1.0", - "resolved": "https://registry.npmjs.org/react-tabs/-/react-tabs-6.1.0.tgz", - "integrity": "sha512-6QtbTRDKM+jA/MZTTefvigNxo0zz+gnBTVFw2CFVvq+f2BuH0nF0vDLNClL045nuTAdOoK/IL1vTP0ZLX0DAyQ==", + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/react-tabs/-/react-tabs-6.1.1.tgz", + "integrity": "sha512-CPiuKoMFf89B7QlbFfdBD9XmUWiE3qudQputMVZB8GQvPJZRX/gqjDaDWOPDwGinEfpJKEuBCkGt83Tt4efeyA==", "license": "MIT", "dependencies": { "clsx": "^2.0.0", @@ -2813,22 +2067,10 @@ "once": "^1.3.0" } }, - "node_modules/readdirp": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", - "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", - "license": "MIT", - "dependencies": { - "picomatch": "^2.2.1" - }, - "engines": { - "node": ">=8.10.0" - } - }, "node_modules/redoc": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.5.0.tgz", - "integrity": "sha512-NpYsOZ1PD9qFdjbLVBZJWptqE+4Y6TkUuvEOqPUmoH7AKOmPcE+hYjotLxQNTqVoWL4z0T2uxILmcc8JGDci+Q==", + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.5.1.tgz", + "integrity": "sha512-LmqA+4A3CmhTllGG197F0arUpmChukAj9klfSdxNRemT9Hr07xXr7OGKu4PHzBs359sgrJ+4JwmOlM7nxLPGMg==", "license": "MIT", "dependencies": { "@redocly/openapi-core": "^1.4.0", @@ -2840,7 +2082,7 @@ "lunr": "^2.3.9", "mark.js": "^8.11.1", "marked": "^4.3.0", - "mobx-react": "^9.1.1", + "mobx-react": "9.2.0", "openapi-sampler": "^1.5.0", "path-browserify": "^1.0.1", "perfect-scrollbar": "^1.5.5", @@ -2865,6 +2107,70 @@ "styled-components": "^4.1.1 || ^5.1.1 || ^6.0.5" } }, + "node_modules/redoc/node_modules/@redocly/ajv": { + "version": "8.11.2", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.11.2.tgz", + "integrity": "sha512-io1JpnwtIcvojV7QKDUSIuMN/ikdOUd1ReEnUnMKGfDVridQZ31J0MmIuqwuRjWDZfmvr+Q0MqCcfHM2gTivOg==", + "license": "MIT", + "dependencies": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js-replace": "^1.0.1" + }, + "funding": { + "type": "github", + "url": "https://github.com/sponsors/epoberezkin" + } + }, + "node_modules/redoc/node_modules/@redocly/config": { + "version": "0.22.0", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", + "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==", + "license": "MIT" + }, + "node_modules/redoc/node_modules/@redocly/openapi-core": { + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", + "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", + "license": "MIT", + "dependencies": { + "@redocly/ajv": "8.11.2", + "@redocly/config": "0.22.0", + "colorette": "1.4.0", + "https-proxy-agent": "7.0.6", + "js-levenshtein": "1.1.6", + "js-yaml": "4.1.1", + "minimatch": "5.1.9", + "pluralize": "8.0.0", + "yaml-ast-parser": "0.0.43" + }, + "engines": { + "node": ">=18.17.0", + "npm": ">=9.5.0" + } + }, + "node_modules/redoc/node_modules/brace-expansion": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", + "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0" + } + }, + "node_modules/redoc/node_modules/minimatch": { + "version": "5.1.9", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", + "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", + "license": "ISC", + "dependencies": { + "brace-expansion": "^2.0.1" + }, + "engines": { + "node": ">=10" + } + }, "node_modules/reftools": { "version": "1.1.9", "resolved": "https://registry.npmjs.org/reftools/-/reftools-1.1.9.tgz", @@ -2912,18 +2218,6 @@ "url": "https://github.com/sponsors/ljharb" } }, - "node_modules/run-applescript": { - "version": "7.1.0", - "resolved": "https://registry.npmjs.org/run-applescript/-/run-applescript-7.1.0.tgz", - "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==", - "license": "MIT", - "engines": { - "node": ">=18" - }, - "funding": { - "url": "https://github.com/sponsors/sindresorhus" - } - }, "node_modules/safe-buffer": { "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", @@ -2946,7 +2240,8 @@ "node_modules/scheduler": { "version": "0.27.0", "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz", - "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==" + "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==", + "license": "MIT" }, "node_modules/semver": { "version": "5.7.2", @@ -2958,9 +2253,9 @@ } }, "node_modules/set-cookie-parser": { - "version": "2.7.1", - "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.1.tgz", - "integrity": "sha512-IOc8uWeOZgnb3ptbCURJWNjWUPcO3ZnTTdzsurqERrP6nPyv+paC55vJM0LpOlT2ne+Ix+9+CRG1MNLlyZ4GjQ==", + "version": "2.7.2", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", + "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==", "license": "MIT" }, "node_modules/shallowequal": { @@ -3285,18 +2580,6 @@ "url": "https://github.com/Mermade/oas-kit?sponsor=1" } }, - "node_modules/to-regex-range": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", - "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", - "license": "MIT", - "dependencies": { - "is-number": "^7.0.0" - }, - "engines": { - "node": ">=8.0" - } - }, "node_modules/tr46": { "version": "0.0.3", "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", @@ -3312,18 +2595,18 @@ "node": ">=0.6" } }, + "node_modules/ts-algebra": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-1.2.2.tgz", + "integrity": "sha512-kloPhf1hq3JbCPOTYoOWDKxebWjNb2o/LKnNfkWhxVVisFFmMJPPdJeGoGmM+iRLyoXAR61e08Pb+vUXINg8aA==", + "license": "MIT" + }, "node_modules/tslib": { "version": "2.8.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", "license": "0BSD" }, - "node_modules/typedarray": { - "version": "0.0.6", - "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", - "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==", - "license": "MIT" - }, "node_modules/uglify-js": { "version": "3.19.3", "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", @@ -3336,10 +2619,19 @@ "node": ">=0.8.0" } }, + "node_modules/ulid": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/ulid/-/ulid-3.0.2.tgz", + "integrity": "sha512-yu26mwteFYzBAot7KVMqFGCVpsF6g8wXfJzQUHvu1no3+rRRSFcSV2nKeYvNPLD2J4b08jYBDhHUjeH0ygIl9w==", + "license": "MIT", + "bin": { + "ulid": "dist/cli.js" + } + }, "node_modules/undici": { - "version": "6.24.1", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.1.tgz", - "integrity": "sha512-sC+b0tB1whOCzbtlx20fx3WgCXwkW627p4EA9uM+/tNNPkSS+eSEld6pAs9nDv7WbY1UUljBMYPtu9BCOrCWKA==", + "version": "6.24.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.0.tgz", + "integrity": "sha512-lVLNosgqo5EkGqh5XUDhGfsMSoO8K0BAN0TyJLvwNRSl4xWGZlCVYsAIpa/OpA3TvmnM01GWcoKmc3ZWo5wKKA==", "license": "MIT", "engines": { "node": ">=18.17" @@ -3348,7 +2640,8 @@ "node_modules/undici-types": { "version": "7.18.2", "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", - "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==" + "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==", + "license": "MIT" }, "node_modules/uri-js-replace": { "version": "1.0.1", @@ -3366,6 +2659,7 @@ "version": "1.6.0", "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz", "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==", + "license": "MIT", "peerDependencies": { "react": "^16.8.0 || ^17.0.0 || ^18.0.0 || ^19.0.0" } @@ -3465,7 +2759,8 @@ "node_modules/wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", - "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=" + "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=", + "dev": true }, "node_modules/ws": { "version": "7.5.10", @@ -3556,9 +2851,9 @@ "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==" }, "@babel/runtime": { - "version": "7.28.4", - "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.28.4.tgz", - "integrity": "sha512-Q/N6JNWvIvPnLDvjlE1OUBLPQHH6l3CltCEsHIujp45zQUSSh8K+gHnaEX45yAT1nyngnINhvWtzN+Nb9D8RAQ==" + "version": "7.29.2", + "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.2.tgz", + "integrity": "sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==" }, "@emotion/is-prop-valid": { "version": "1.4.0", @@ -3593,166 +2888,125 @@ "resolved": "https://registry.npmjs.org/@humanwhocodes/momoa/-/momoa-2.0.4.tgz", "integrity": "sha512-RE815I4arJFtt+FVeU1Tgp9/Xvecacji8w/V6XtXsWWH/wz/eNkNbhb+ny/+PlVZjV0rxQpRSQKNKE3lcktHEA==" }, - "@jest/schemas": { - "version": "29.6.3", - "resolved": "https://registry.npmjs.org/@jest/schemas/-/schemas-29.6.3.tgz", - "integrity": "sha512-mo5j5X+jIZmJQveBKeS/clAueipV7KgiX1vMgCxam1RNYiqE1w62n0/tJJnHtjW8ZHcQco5gY85jA3mi0L+nSA==", - "requires": { - "@sinclair/typebox": "^0.27.8" - } - }, - "@jsep-plugin/assignment": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/@jsep-plugin/assignment/-/assignment-1.3.0.tgz", - "integrity": "sha512-VVgV+CXrhbMI3aSusQyclHkenWSAm95WaiKrMxRFam3JSUiIaQjoMIw2sEs/OX4XifnqeQUN4DYbJjlA8EfktQ==", - "requires": {} - }, - "@jsep-plugin/regex": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/@jsep-plugin/regex/-/regex-1.0.4.tgz", - "integrity": "sha512-q7qL4Mgjs1vByCaTnDFcBnV9HS7GVPJX5vyVoCgZHNSC9rjwIlmbXG5sUuorR5ndfHAIlJ8pVStxvjXHbNvtUg==", - "requires": {} + "@noble/hashes": { + "version": "1.8.0", + "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz", + "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==" }, "@opentelemetry/api": { - "version": "1.9.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.0.tgz", - "integrity": "sha512-3giAOQvZiH5F9bMlMiv8+GSPMeqg0dbaeo58/0SlA9sxSqZhnUtxzX9/2FzyhS9sWQf5S0GJE0AKBrFqjpeYcg==" + "version": "1.9.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz", + "integrity": "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q==" }, "@opentelemetry/api-logs": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.53.0.tgz", - "integrity": "sha512-8HArjKx+RaAI8uEIgcORbZIPklyh1YLjPSBus8hjRmvLi6DeFzgOcdZ7KwPabKj8mXF8dX0hyfAyGfycz0DbFw==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.202.0.tgz", + "integrity": "sha512-fTBjMqKCfotFWfLzaKyhjLvyEyq5vDKTTFfBmx21btv3gvy8Lq6N5Dh2OzqeuN4DjtpSvNT1uNVfg08eD2Rfxw==", "requires": { - "@opentelemetry/api": "^1.0.0" + "@opentelemetry/api": "^1.3.0" } }, "@opentelemetry/context-async-hooks": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-1.26.0.tgz", - "integrity": "sha512-HedpXXYzzbaoutw6DFLWLDket2FwLkLpil4hGCZ1xYEIMTcivdfwEOISgdbLEWyG3HW52gTq2V9mOVJrONgiwg==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-2.0.1.tgz", + "integrity": "sha512-XuY23lSI3d4PEqKA+7SLtAgwqIfc6E/E9eAQWLN1vlpC53ybO3o6jW4BsXo1xvz9lYyyWItfQDDLzezER01mCw==", "requires": {} }, "@opentelemetry/core": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-1.26.0.tgz", - "integrity": "sha512-1iKxXXE8415Cdv0yjG3G6hQnB5eVEsJce3QaawX8SjDn0mAS0ZM8fAbZZJD4ajvhC15cePvosSCut404KrIIvQ==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", + "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", "requires": { - "@opentelemetry/semantic-conventions": "1.27.0" + "@opentelemetry/semantic-conventions": "^1.29.0" } }, "@opentelemetry/exporter-trace-otlp-http": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.53.0.tgz", - "integrity": "sha512-m7F5ZTq+V9mKGWYpX8EnZ7NjoqAU7VemQ1E2HAG+W/u0wpY1x0OmbxAXfGKFHCspdJk8UKlwPGrpcB8nay3P8A==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.202.0.tgz", + "integrity": "sha512-/hKE8DaFCJuaQqE1IxpgkcjOolUIwgi3TgHElPVKGdGRBSmJMTmN/cr6vWa55pCJIXPyhKvcMrbrya7DZ3VmzA==", "requires": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/otlp-exporter-base": "0.53.0", - "@opentelemetry/otlp-transformer": "0.53.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/sdk-trace-base": "1.26.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-exporter-base": "0.202.0", + "@opentelemetry/otlp-transformer": "0.202.0", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1" } }, "@opentelemetry/otlp-exporter-base": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.53.0.tgz", - "integrity": "sha512-UCWPreGQEhD6FjBaeDuXhiMf6kkBODF0ZQzrk/tuQcaVDJ+dDQ/xhJp192H9yWnKxVpEjFrSSLnpqmX4VwX+eA==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.202.0.tgz", + "integrity": "sha512-nMEOzel+pUFYuBJg2znGmHJWbmvMbdX5/RhoKNKowguMbURhz0fwik5tUKplLcUtl8wKPL1y9zPnPxeBn65N0Q==", "requires": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/otlp-transformer": "0.53.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/otlp-transformer": "0.202.0" } }, "@opentelemetry/otlp-transformer": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.53.0.tgz", - "integrity": "sha512-rM0sDA9HD8dluwuBxLetUmoqGJKSAbWenwD65KY9iZhUxdBHRLrIdrABfNDP7aiTjcgK8XFyTn5fhDz7N+W6DA==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.202.0.tgz", + "integrity": "sha512-5XO77QFzs9WkexvJQL9ksxL8oVFb/dfi9NWQSq7Sv0Efr9x3N+nb1iklP1TeVgxqJ7m1xWiC/Uv3wupiQGevMw==", "requires": { - "@opentelemetry/api-logs": "0.53.0", - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/sdk-logs": "0.53.0", - "@opentelemetry/sdk-metrics": "1.26.0", - "@opentelemetry/sdk-trace-base": "1.26.0", + "@opentelemetry/api-logs": "0.202.0", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-logs": "0.202.0", + "@opentelemetry/sdk-metrics": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1", "protobufjs": "^7.3.0" } }, - "@opentelemetry/propagator-b3": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/propagator-b3/-/propagator-b3-1.26.0.tgz", - "integrity": "sha512-vvVkQLQ/lGGyEy9GT8uFnI047pajSOVnZI2poJqVGD3nJ+B9sFGdlHNnQKophE3lHfnIH0pw2ubrCTjZCgIj+Q==", - "requires": { - "@opentelemetry/core": "1.26.0" - } - }, - "@opentelemetry/propagator-jaeger": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/propagator-jaeger/-/propagator-jaeger-1.26.0.tgz", - "integrity": "sha512-DelFGkCdaxA1C/QA0Xilszfr0t4YbGd3DjxiCDPh34lfnFr+VkkrjV9S8ZTJvAzfdKERXhfOxIKBoGPJwoSz7Q==", - "requires": { - "@opentelemetry/core": "1.26.0" - } - }, "@opentelemetry/resources": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-1.26.0.tgz", - "integrity": "sha512-CPNYchBE7MBecCSVy0HKpUISEeJOniWqcHaAHpmasZ3j9o6V3AyBzhRc90jdmemq0HOxDr6ylhUbDhBqqPpeNw==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", + "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", "requires": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/semantic-conventions": "1.27.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" } }, "@opentelemetry/sdk-logs": { - "version": "0.53.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.53.0.tgz", - "integrity": "sha512-dhSisnEgIj/vJZXZV6f6KcTnyLDx/VuQ6l3ejuZpMpPlh9S1qMHiZU9NMmOkVkwwHkMy3G6mEBwdP23vUZVr4g==", + "version": "0.202.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.202.0.tgz", + "integrity": "sha512-pv8QiQLQzk4X909YKm0lnW4hpuQg4zHwJ4XBd5bZiXcd9urvrJNoNVKnxGHPiDVX/GiLFvr5DMYsDBQbZCypRQ==", "requires": { - "@opentelemetry/api-logs": "0.53.0", - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0" + "@opentelemetry/api-logs": "0.202.0", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1" } }, "@opentelemetry/sdk-metrics": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-1.26.0.tgz", - "integrity": "sha512-0SvDXmou/JjzSDOjUmetAAvcKQW6ZrvosU0rkbDGpXvvZN+pQF6JbK/Kd4hNdK4q/22yeruqvukXEJyySTzyTQ==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-2.0.1.tgz", + "integrity": "sha512-wf8OaJoSnujMAHWR3g+/hGvNcsC16rf9s1So4JlMiFaFHiE4HpIA3oUh+uWZQ7CNuK8gVW/pQSkgoa5HkkOl0g==", "requires": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1" } }, "@opentelemetry/sdk-trace-base": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-1.26.0.tgz", - "integrity": "sha512-olWQldtvbK4v22ymrKLbIcBi9L2SpMO84sCPY54IVsJhP9fRsxJT194C/AVaAuJzLE30EdhhM1VmvVYR7az+cw==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", + "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", "requires": { - "@opentelemetry/core": "1.26.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/semantic-conventions": "1.27.0" + "@opentelemetry/core": "2.0.1", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/semantic-conventions": "^1.29.0" } }, "@opentelemetry/sdk-trace-node": { - "version": "1.26.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-1.26.0.tgz", - "integrity": "sha512-Fj5IVKrj0yeUwlewCRwzOVcr5avTuNnMHWf7GPc1t6WaT78J6CJyF3saZ/0RkZfdeNO8IcBl/bNcWMVZBMRW8Q==", + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-2.0.1.tgz", + "integrity": "sha512-UhdbPF19pMpBtCWYP5lHbTogLWx9N0EBxtdagvkn5YtsAnCBZzL7SjktG+ZmupRgifsHMjwUaCCaVmqGfSADmA==", "requires": { - "@opentelemetry/context-async-hooks": "1.26.0", - "@opentelemetry/core": "1.26.0", - "@opentelemetry/propagator-b3": "1.26.0", - "@opentelemetry/propagator-jaeger": "1.26.0", - "@opentelemetry/sdk-trace-base": "1.26.0", - "semver": "^7.5.2" - }, - "dependencies": { - "semver": { - "version": "7.7.1", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.1.tgz", - "integrity": "sha512-hlq8tAfn0m/61p4BVRcPzIGr6LKiMwo4VM6dGi6pt4qcRkmNzTcWq6eCEjEh+qXjkMDvPlOFFSGwQjoEa6gyMA==" - } + "@opentelemetry/context-async-hooks": "2.0.1", + "@opentelemetry/core": "2.0.1", + "@opentelemetry/sdk-trace-base": "2.0.1" } }, "@opentelemetry/semantic-conventions": { - "version": "1.27.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.27.0.tgz", - "integrity": "sha512-sAay1RrB+ONOem0OZanAR1ZI/k7yDpnOQSQmTMuGImUQb2y8EbSaCJ94FQluM74xoU03vlb2d2U90hZluL6nQg==" + "version": "1.34.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.34.0.tgz", + "integrity": "sha512-aKcOkyrorBGlajjRdVoJWHTxfxO1vCNHLJVlSDaRHDIdjU+pX8IYQPvPDkYiujKLbRnWU+1TBwEt0QRgSm4SGA==" }, "@protobufjs/aspromise": { "version": "1.1.2", @@ -3809,58 +3063,82 @@ "integrity": "sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==" }, "@redocly/ajv": { - "version": "8.11.2", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.11.2.tgz", - "integrity": "sha512-io1JpnwtIcvojV7QKDUSIuMN/ikdOUd1ReEnUnMKGfDVridQZ31J0MmIuqwuRjWDZfmvr+Q0MqCcfHM2gTivOg==", + "version": "8.18.1", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.1.tgz", + "integrity": "sha512-Ifm/pP/tul1qmAecpbVxCBluVE32rKfjf8gYXH4xI2gCv9mRWFhJMHzkPDM4TXlxwPQYIFegymlsy8lXz7optA==", "requires": { - "fast-deep-equal": "^3.1.1", + "fast-deep-equal": "^3.1.3", + "fast-uri": "^3.0.1", "json-schema-traverse": "^1.0.0", - "require-from-string": "^2.0.2", - "uri-js-replace": "^1.0.1" + "require-from-string": "^2.0.2" } }, "@redocly/cli": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-1.34.11.tgz", - "integrity": "sha512-NTFegt2uQ0A4xewDPcTadsZYSlmEUzF7wnvRgmFI8Ftvjpq/coIdr9EQPmCF6wjrh9UBKdz2rMNckxLo/jhViA==", + "version": "2.25.3", + "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-2.25.3.tgz", + "integrity": "sha512-02wjApwJwGD+kGWRoiFVY0Hq960ydMAMHrK3AJH2LMiYNYcrzAr1FSbA3OSylvg2gx3w/r1r710B+iMz3KJKbw==", "requires": { - "@opentelemetry/api": "1.9.0", - "@opentelemetry/exporter-trace-otlp-http": "0.53.0", - "@opentelemetry/resources": "1.26.0", - "@opentelemetry/sdk-trace-node": "1.26.0", - "@opentelemetry/semantic-conventions": "1.27.0", - "@redocly/config": "0.22.0", - "@redocly/openapi-core": "1.34.11", - "@redocly/respect-core": "1.34.11", - "abort-controller": "3.0.0", - "chokidar": "3.5.3", - "colorette": "1.4.0", - "core-js": "3.32.1", + "@opentelemetry/exporter-trace-otlp-http": "0.202.0", + "@opentelemetry/resources": "2.0.1", + "@opentelemetry/sdk-trace-node": "2.0.1", + "@opentelemetry/semantic-conventions": "1.34.0", + "@redocly/cli-otel": "0.1.2", + "@redocly/openapi-core": "2.25.3", + "@redocly/respect-core": "2.25.3", + "abort-controller": "^3.0.0", + "ajv": "npm:@redocly/ajv@8.18.0", + "ajv-formats": "^3.0.1", + "colorette": "^1.2.0", + "cookie": "^0.7.2", "dotenv": "16.4.7", - "form-data": "4.0.4", - "get-port-please": "3.0.1", - "glob": "7.2.3", - "handlebars": "4.7.8", - "mobx": "6.12.3", - "pluralize": "8.0.0", + "glob": "^13.0.5", + "handlebars": "^4.7.9", + "https-proxy-agent": "^7.0.5", + "mobx": "^6.0.4", + "picomatch": "^4.0.4", + "pluralize": "^8.0.0", "react": "^17.0.0 || ^18.2.0 || ^19.2.1", "react-dom": "^17.0.0 || ^18.2.0 || ^19.2.1", - "redoc": "2.5.0", - "semver": "7.7.4", - "simple-websocket": "9.1.0", + "redoc": "2.5.1", + "semver": "^7.5.2", + "set-cookie-parser": "^2.3.5", + "simple-websocket": "^9.0.0", "styled-components": "6.3.9", + "ulid": "^3.0.1", + "undici": "6.24.0", "yargs": "17.0.1" }, "dependencies": { - "core-js": { - "version": "3.32.1", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.32.1.tgz", - "integrity": "sha512-lqufgNn9NLnESg5mQeYsxQP5w7wrViSj0jr/kv6ECQiByzQkrn1MKvV0L3acttpDqfQrHLwr2KCMgX5b8X+lyQ==" + "balanced-match": { + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==" + }, + "brace-expansion": { + "version": "5.0.5", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz", + "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==", + "requires": { + "balanced-match": "^4.0.2" + } + }, + "glob": { + "version": "13.0.6", + "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz", + "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", + "requires": { + "minimatch": "^10.2.2", + "minipass": "^7.1.3", + "path-scurry": "^2.0.2" + } }, - "mobx": { - "version": "6.12.3", - "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.12.3.tgz", - "integrity": "sha512-c8NKkO4R2lShkSXZ2Ongj1ycjugjzFFo/UswHBnS62y07DMcTc9Rvo03/3nRyszIvwPNljlkd4S828zIBv/piw==" + "minimatch": { + "version": "10.2.4", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz", + "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==", + "requires": { + "brace-expansion": "^5.0.2" + } }, "semver": { "version": "7.7.4", @@ -3869,110 +3147,81 @@ } } }, + "@redocly/cli-otel": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/@redocly/cli-otel/-/cli-otel-0.1.2.tgz", + "integrity": "sha512-Bg7BoO5t1x3lVK+KhA5aGPmeXpQmdf6WtTYHhelKJCsQ+tRMiJoFAQoKHoBHAoNxXrhlS3K9lKFLHGmtxsFQfA==", + "requires": { + "ulid": "^2.3.0" + }, + "dependencies": { + "ulid": { + "version": "2.4.0", + "resolved": "https://registry.npmjs.org/ulid/-/ulid-2.4.0.tgz", + "integrity": "sha512-fIRiVTJNcSRmXKPZtGzFQv9WRrZ3M9eoptl/teFJvjOzmpU+/K/JH6HZ8deBfb5vMEpicJcLn7JmvdknlMq7Zg==" + } + } + }, "@redocly/config": { - "version": "0.22.0", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", - "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==" + "version": "0.45.0", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.45.0.tgz", + "integrity": "sha512-V+wNusPQUaYV1c5s9iptfKQ2Ggno4bMeiyXdNILxqZS87gttwPfqlqHKHKFyz006voS3JsR295cbpx3GlsIxKg==", + "requires": { + "json-schema-to-ts": "2.7.2" + } }, "@redocly/openapi-core": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", - "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", + "version": "2.25.3", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.25.3.tgz", + "integrity": "sha512-GIu3Mdym5IDIPCvXTzMZ6TQw/+7sKd52PdysxNVe7zBk22ExSGnVE9UAk9BaLOzXT77PJWDUwaimBdJoPpxHMA==", "requires": { - "@redocly/ajv": "8.11.2", - "@redocly/config": "0.22.0", - "colorette": "1.4.0", - "https-proxy-agent": "7.0.6", - "js-levenshtein": "1.1.6", - "js-yaml": "4.1.1", - "minimatch": "5.1.9", - "pluralize": "8.0.0", + "@redocly/ajv": "^8.18.0", + "@redocly/config": "^0.45.0", + "ajv": "npm:@redocly/ajv@8.18.0", + "ajv-formats": "^3.0.1", + "colorette": "^1.2.0", + "js-levenshtein": "^1.1.6", + "js-yaml": "^4.1.0", + "picomatch": "^4.0.4", + "pluralize": "^8.0.0", "yaml-ast-parser": "0.0.43" - }, - "dependencies": { - "brace-expansion": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", - "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", - "requires": { - "balanced-match": "^1.0.0" - } - }, - "minimatch": { - "version": "5.1.9", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", - "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", - "requires": { - "brace-expansion": "^2.0.1" - } - } } }, "@redocly/respect-core": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-1.34.11.tgz", - "integrity": "sha512-0USZA1iRkyCZN/o5ZmgJ9vFVfWe5dE6m2IabF4g7s8EWJErbRFc8LoJ20hfoR75yGUfde+0vTPNOG5T9dlqq1g==", + "version": "2.25.3", + "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.25.3.tgz", + "integrity": "sha512-07m80JYdp7J7kH4D1Vqdpa2ZBFCv3QAwCoh2w9H3OjuT/rXQkBSkJQm1n70fzO/HuUf4azzULdp2XnsIpxP2qw==", "requires": { - "@faker-js/faker": "7.6.0", - "@redocly/ajv": "8.11.2", - "@redocly/openapi-core": "1.34.11", - "better-ajv-errors": "1.2.0", - "colorette": "2.0.20", - "concat-stream": "2.0.0", - "cookie": "0.7.2", - "dotenv": "16.4.7", - "form-data": "4.0.4", - "jest-diff": "29.7.0", - "jest-matcher-utils": "29.7.0", - "js-yaml": "4.1.0", - "json-pointer": "0.6.2", - "jsonpath-plus": "10.3.0", - "open": "10.1.0", - "openapi-sampler": "1.7.0", - "outdent": "0.8.0", - "set-cookie-parser": "2.7.1", - "undici": "6.24.1" + "@faker-js/faker": "^7.6.0", + "@noble/hashes": "^1.8.0", + "@redocly/ajv": "^8.18.0", + "@redocly/openapi-core": "2.25.3", + "ajv": "npm:@redocly/ajv@8.18.0", + "better-ajv-errors": "^1.2.0", + "colorette": "^2.0.20", + "json-pointer": "^0.6.2", + "jsonpath-rfc9535": "1.3.0", + "openapi-sampler": "^1.7.1", + "outdent": "^0.8.0", + "picomatch": "^4.0.4" }, "dependencies": { "colorette": { "version": "2.0.20", "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz", "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==" - }, - "js-yaml": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.0.tgz", - "integrity": "sha512-wpxZs9NoxZaJESJGIZTyDEaYpl0FKSA+FB9aJiyemKhMwkxQg63h4T1KJgUGHpTqPDNRcmmYLugrRjJlBtWvRA==", - "requires": { - "argparse": "^2.0.1" - } - }, - "openapi-sampler": { - "version": "1.7.0", - "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.0.tgz", - "integrity": "sha512-fWq32F5vqGpgRJYIarC/9Y1wC9tKnRDcCOjsDJ7MIcSv2HsE7kNifcXIZ8FVtNStBUWxYrEk/MKqVF0SwZ5gog==", - "requires": { - "@types/json-schema": "^7.0.7", - "fast-xml-parser": "^5.3.4", - "json-pointer": "0.6.2" - } } } }, - "@sinclair/typebox": { - "version": "0.27.10", - "resolved": "https://registry.npmjs.org/@sinclair/typebox/-/typebox-0.27.10.tgz", - "integrity": "sha512-MTBk/3jGLNB2tVxv6uLlFh1iu64iYOQ2PbdOSK3NW8JZsmlaOh2q6sdtKowBhfw8QFLmYNzTW4/oK4uATIi6ZA==" - }, "@types/json-schema": { "version": "7.0.15", "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==" }, "@types/node": { - "version": "25.4.0", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.4.0.tgz", - "integrity": "sha512-9wLpoeWuBlcbBpOY3XmzSTG3oscB6xjBEEtn+pYXTfhyXhIxC5FsBer2KTopBlvKEiW9l13po9fq+SJY/5lkhw==", + "version": "25.5.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.5.0.tgz", + "integrity": "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw==", "requires": { "undici-types": "~7.18.0" } @@ -4008,10 +3257,9 @@ "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==" }, "ajv": { - "version": "8.18.0", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-8.18.0.tgz", - "integrity": "sha512-PlXPeEWMXMZ7sPYOHqmDyCJzcfNrUr3fGNKtezX14ykXOEIvyK81d+qydx89KY5O71FKMPaQ2vBfBFI5NHR63A==", - "peer": true, + "version": "npm:@redocly/ajv@8.18.0", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.0.tgz", + "integrity": "sha512-F+LMD2IDIXuHxgpLJh3nkLj9+tSaEzoUWd+7fONGq5pe2169FUDjpEkOfEpoGLz1sbZni/69p07OsecNfAOpqA==", "requires": { "fast-deep-equal": "^3.1.3", "fast-uri": "^3.0.1", @@ -4019,6 +3267,14 @@ "require-from-string": "^2.0.2" } }, + "ajv-formats": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", + "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", + "requires": { + "ajv": "^8.0.0" + } + }, "ansi-regex": { "version": "5.0.1", "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", @@ -4033,15 +3289,6 @@ "color-convert": "^1.9.0" } }, - "anymatch": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/anymatch/-/anymatch-3.1.3.tgz", - "integrity": "sha512-KMReFUr0B4t+D+OBkjR3KYqvocp2XaSzO55UcB6mgQMd3KbcE+mWTyvVV7D/zsdEbNnV6acZUutkiHQXvTr1Rw==", - "requires": { - "normalize-path": "^3.0.0", - "picomatch": "^2.0.4" - } - }, "argparse": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", @@ -4059,11 +3306,6 @@ "integrity": "sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=", "dev": true }, - "asynckit": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", - "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==" - }, "balanced-match": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", @@ -4126,50 +3368,16 @@ } } }, - "binary-extensions": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/binary-extensions/-/binary-extensions-2.3.0.tgz", - "integrity": "sha512-Ceh+7ox5qe7LJuLHoY0feh3pHuUDHAcRUeyL2VYghZwfpkNIy/+8Ocg0a3UuSoYzavmylwuLWQOf3hl0jjMMIw==" - }, "brace-expansion": { "version": "1.1.12", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "dev": true, "requires": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" } }, - "braces": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", - "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", - "requires": { - "fill-range": "^7.1.1" - } - }, - "buffer-from": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/buffer-from/-/buffer-from-1.1.2.tgz", - "integrity": "sha512-E+XQCRwSbaaiChtv6k6Dwgc+bx+Bs6vuKJHHl5kox/BaKbhiXzqQOwK4cO22yElGp2OCmjwVhT3HmxgyPGnJfQ==" - }, - "bundle-name": { - "version": "4.1.0", - "resolved": "https://registry.npmjs.org/bundle-name/-/bundle-name-4.1.0.tgz", - "integrity": "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q==", - "requires": { - "run-applescript": "^7.0.0" - } - }, - "call-bind-apply-helpers": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz", - "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==", - "requires": { - "es-errors": "^1.3.0", - "function-bind": "^1.1.2" - } - }, "call-me-maybe": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", @@ -4191,21 +3399,6 @@ "supports-color": "^5.3.0" } }, - "chokidar": { - "version": "3.5.3", - "resolved": "https://registry.npmjs.org/chokidar/-/chokidar-3.5.3.tgz", - "integrity": "sha512-Dr3sfKRP6oTcjf2JmUmFJfeVMvXBdegxB0iVQ5eb2V10uFJUCAS8OByZdVAyVb8xXNz3GjjTgj9kLWsZTqE6kw==", - "requires": { - "anymatch": "~3.1.2", - "braces": "~3.0.2", - "fsevents": "~2.3.2", - "glob-parent": "~5.1.2", - "is-binary-path": "~2.1.0", - "is-glob": "~4.0.1", - "normalize-path": "~3.0.0", - "readdirp": "~3.6.0" - } - }, "classnames": { "version": "2.5.1", "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.5.1.tgz", @@ -4246,29 +3439,11 @@ "resolved": "https://registry.npmjs.org/colorette/-/colorette-1.4.0.tgz", "integrity": "sha512-Y2oEozpomLn7Q3HFP7dpww7AtMJplbM9lGZP6RDfHqmbeRjiwRg4n6VM6j4KLmRke85uWEI7JqF17f3pqdRA0g==" }, - "combined-stream": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", - "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", - "requires": { - "delayed-stream": "~1.0.0" - } - }, "concat-map": { "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=" - }, - "concat-stream": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/concat-stream/-/concat-stream-2.0.0.tgz", - "integrity": "sha512-MWufYdFw53ccGjCA+Ol7XJYpAlW6/prSMzuPOTRnJGcGzuhLn4Scrz7qf6o8bROZ514ltazcIFJZevcfbo0x7A==", - "requires": { - "buffer-from": "^1.0.0", - "inherits": "^2.0.3", - "readable-stream": "^3.0.2", - "typedarray": "^0.0.6" - } + "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", + "dev": true }, "cookie": { "version": "0.7.2", @@ -4276,9 +3451,9 @@ "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==" }, "core-js": { - "version": "3.48.0", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.48.0.tgz", - "integrity": "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ==", + "version": "3.49.0", + "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.49.0.tgz", + "integrity": "sha512-es1U2+YTtzpwkxVLwAFdSpaIMyQaq0PBgm3YD1W3Qpsn1NAmO3KSgZfu+oGSWVu6NvLHoHCV/aYcsE5wiB7ALg==", "peer": true }, "css-color-keywords": { @@ -4317,32 +3492,8 @@ }, "decko": { "version": "1.2.0", - "resolved": "https://registry.npmjs.org/decko/-/decko-1.2.0.tgz", - "integrity": "sha512-m8FnyHXV1QX+S1cl+KPFDIl6NMkxtKsy6+U/aYyjrOqWMuwAwYWu7ePqrsUHtDR5Y8Yk2pi/KIDSgF+vT4cPOQ==" - }, - "default-browser": { - "version": "5.5.0", - "resolved": "https://registry.npmjs.org/default-browser/-/default-browser-5.5.0.tgz", - "integrity": "sha512-H9LMLr5zwIbSxrmvikGuI/5KGhZ8E2zH3stkMgM5LpOWDutGM2JZaj460Udnf1a+946zc7YBgrqEWwbk7zHvGw==", - "requires": { - "bundle-name": "^4.1.0", - "default-browser-id": "^5.0.0" - } - }, - "default-browser-id": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/default-browser-id/-/default-browser-id-5.0.1.tgz", - "integrity": "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q==" - }, - "define-lazy-prop": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/define-lazy-prop/-/define-lazy-prop-3.0.0.tgz", - "integrity": "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg==" - }, - "delayed-stream": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", - "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==" + "resolved": "https://registry.npmjs.org/decko/-/decko-1.2.0.tgz", + "integrity": "sha512-m8FnyHXV1QX+S1cl+KPFDIl6NMkxtKsy6+U/aYyjrOqWMuwAwYWu7ePqrsUHtDR5Y8Yk2pi/KIDSgF+vT4cPOQ==" }, "dezalgo": { "version": "1.0.4", @@ -4354,15 +3505,10 @@ "wrappy": "1" } }, - "diff-sequences": { - "version": "29.6.3", - "resolved": "https://registry.npmjs.org/diff-sequences/-/diff-sequences-29.6.3.tgz", - "integrity": "sha512-EjePK1srD3P08o2j4f0ExnylqRs5B9tJjcp9t1krH2qRi8CCdsYfwe9JgSLurFBWwq4uOlipzfk5fHNvwFKr8Q==" - }, "dompurify": { - "version": "3.3.2", - "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.2.tgz", - "integrity": "sha512-6obghkliLdmKa56xdbLOpUZ43pAR6xFy1uOrxBaIDjT+yaRuuybLjGS9eVBoSR/UPU5fq3OXClEHLJNGvbxKpQ==", + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.3.tgz", + "integrity": "sha512-Oj6pzI2+RqBfFG+qOaOLbFXLQ90ARpcGG6UePL82bJLtdsa6CYJD7nmiU8MW9nQNOtCHV3lZ/Bzq1X0QYbBZCA==", "requires": { "@types/trusted-types": "^2.0.7" } @@ -4372,50 +3518,11 @@ "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.4.7.tgz", "integrity": "sha512-47qPchRCykZC03FhkYAhrvwU4xDBFIj1QPqaarj6mdM/hgUzfPHcpkHJOn3mJAufFeeAxAzeGsr5X0M4k6fLZQ==" }, - "dunder-proto": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz", - "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==", - "requires": { - "call-bind-apply-helpers": "^1.0.1", - "es-errors": "^1.3.0", - "gopd": "^1.2.0" - } - }, "emoji-regex": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==" }, - "es-define-property": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz", - "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==" - }, - "es-errors": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", - "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==" - }, - "es-object-atoms": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", - "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", - "requires": { - "es-errors": "^1.3.0" - } - }, - "es-set-tostringtag": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz", - "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==", - "requires": { - "es-errors": "^1.3.0", - "get-intrinsic": "^1.2.6", - "has-tostringtag": "^1.0.2", - "hasown": "^2.0.2" - } - }, "es6-promise": { "version": "3.3.1", "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.3.1.tgz", @@ -4438,9 +3545,9 @@ "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==" }, "eventemitter3": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz", - "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==" + "version": "5.0.4", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", + "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==" }, "fast-deep-equal": { "version": "3.1.3", @@ -4455,8 +3562,7 @@ "fast-uri": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz", - "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", - "peer": true + "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==" }, "fast-xml-builder": { "version": "1.1.4", @@ -4476,87 +3582,33 @@ "strnum": "^2.2.2" } }, - "fill-range": { - "version": "7.1.1", - "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", - "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", - "requires": { - "to-regex-range": "^5.0.1" - } - }, "foreach": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/foreach/-/foreach-2.0.6.tgz", "integrity": "sha512-k6GAGDyqLe9JaebCsFCoudPPWfihKu8pylYXRlqP1J7ms39iPoTtk2fviNglIeQEwdh0bQeKJ01ZPyuyQvKzwg==" }, - "form-data": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.4.tgz", - "integrity": "sha512-KrGhL9Q4zjj0kiUt5OO4Mr/A/jlI2jDYs5eHBpYHPcBEVSiipAvn2Ko2HnPe20rmcuuvMHNdZFp+4IlGTMF0Ow==", - "requires": { - "asynckit": "^0.4.0", - "combined-stream": "^1.0.8", - "es-set-tostringtag": "^2.1.0", - "hasown": "^2.0.2", - "mime-types": "^2.1.12" - } - }, "fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=" - }, - "fsevents": { - "version": "2.3.3", - "resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz", - "integrity": "sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==", - "optional": true + "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=", + "dev": true }, "function-bind": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", - "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==" + "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", + "dev": true }, "get-caller-file": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==" }, - "get-intrinsic": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz", - "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==", - "requires": { - "call-bind-apply-helpers": "^1.0.2", - "es-define-property": "^1.0.1", - "es-errors": "^1.3.0", - "es-object-atoms": "^1.1.1", - "function-bind": "^1.1.2", - "get-proto": "^1.0.1", - "gopd": "^1.2.0", - "has-symbols": "^1.1.0", - "hasown": "^2.0.2", - "math-intrinsics": "^1.1.0" - } - }, - "get-port-please": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/get-port-please/-/get-port-please-3.0.1.tgz", - "integrity": "sha512-R5pcVO8Z1+pVDu8Ml3xaJCEkBiiy1VQN9za0YqH8GIi1nIqD4IzQhzY6dDzMRtdS1lyiGlucRzm8IN8wtLIXng==" - }, - "get-proto": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz", - "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==", - "requires": { - "dunder-proto": "^1.0.1", - "es-object-atoms": "^1.0.0" - } - }, "glob": { "version": "7.2.3", "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "dev": true, "requires": { "fs.realpath": "^1.0.0", "inflight": "^1.0.4", @@ -4566,19 +3618,6 @@ "path-is-absolute": "^1.0.0" } }, - "glob-parent": { - "version": "5.1.2", - "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", - "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", - "requires": { - "is-glob": "^4.0.1" - } - }, - "gopd": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz", - "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==" - }, "graceful-fs": { "version": "4.2.11", "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", @@ -4586,9 +3625,9 @@ "dev": true }, "handlebars": { - "version": "4.7.8", - "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.8.tgz", - "integrity": "sha512-vafaFqs8MZkRrSX7sFVUdo3ap/eNiLnb4IakshzvP56X5Nr1iGKAIqdX6tMlm6HcNRIkr6AxO5jFEoJzzpT8aQ==", + "version": "4.7.9", + "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.9.tgz", + "integrity": "sha512-4E71E0rpOaQuJR2A3xDZ+GM1HyWYv1clR58tC8emQNeQe3RH7MAzSbat+V0wG78LQBo6m6bzSG/L4pBuCsgnUQ==", "requires": { "minimist": "^1.2.5", "neo-async": "^2.6.2", @@ -4603,23 +3642,11 @@ "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", "dev": true }, - "has-symbols": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz", - "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==" - }, - "has-tostringtag": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz", - "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==", - "requires": { - "has-symbols": "^1.0.3" - } - }, "hasown": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "dev": true, "requires": { "function-bind": "^1.1.2" } @@ -4648,6 +3675,7 @@ "version": "1.0.6", "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=", + "dev": true, "requires": { "once": "^1.3.0", "wrappy": "1" @@ -4658,14 +3686,6 @@ "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" }, - "is-binary-path": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/is-binary-path/-/is-binary-path-2.1.0.tgz", - "integrity": "sha512-ZMERYes6pDydyuGidse7OsHxtbI7WVeUEozgR/g7rd0xUimYNlvZRE/K2MgZTjWy725IfelLeVcEM97mmtRGXw==", - "requires": { - "binary-extensions": "^2.0.0" - } - }, "is-core-module": { "version": "2.16.1", "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", @@ -4675,167 +3695,11 @@ "hasown": "^2.0.2" } }, - "is-docker": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-docker/-/is-docker-3.0.0.tgz", - "integrity": "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ==" - }, - "is-extglob": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", - "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==" - }, "is-fullwidth-code-point": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==" }, - "is-glob": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", - "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", - "requires": { - "is-extglob": "^2.1.1" - } - }, - "is-inside-container": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/is-inside-container/-/is-inside-container-1.0.0.tgz", - "integrity": "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA==", - "requires": { - "is-docker": "^3.0.0" - } - }, - "is-number": { - "version": "7.0.0", - "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", - "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==" - }, - "is-wsl": { - "version": "3.1.1", - "resolved": "https://registry.npmjs.org/is-wsl/-/is-wsl-3.1.1.tgz", - "integrity": "sha512-e6rvdUCiQCAuumZslxRJWR/Doq4VpPR82kqclvcS0efgt430SlGIk05vdCN58+VrzgtIcfNODjozVielycD4Sw==", - "requires": { - "is-inside-container": "^1.0.0" - } - }, - "jest-diff": { - "version": "29.7.0", - "resolved": "https://registry.npmjs.org/jest-diff/-/jest-diff-29.7.0.tgz", - "integrity": "sha512-LMIgiIrhigmPrs03JHpxUh2yISK3vLFPkAodPeo0+BuF7wA2FoQbkEg1u8gBYBThncu7e1oEDUfIXVuTqLRUjw==", - "requires": { - "chalk": "^4.0.0", - "diff-sequences": "^29.6.3", - "jest-get-type": "^29.6.3", - "pretty-format": "^29.7.0" - }, - "dependencies": { - "ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "requires": { - "color-convert": "^2.0.1" - } - }, - "chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "requires": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" - }, - "has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==" - }, - "supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "requires": { - "has-flag": "^4.0.0" - } - } - } - }, - "jest-get-type": { - "version": "29.6.3", - "resolved": "https://registry.npmjs.org/jest-get-type/-/jest-get-type-29.6.3.tgz", - "integrity": "sha512-zrteXnqYxfQh7l5FHyL38jL39di8H8rHoecLH3JNxH3BwOrBsNeabdap5e0I23lD4HHI8W5VFBZqG4Eaq5LNcw==" - }, - "jest-matcher-utils": { - "version": "29.7.0", - "resolved": "https://registry.npmjs.org/jest-matcher-utils/-/jest-matcher-utils-29.7.0.tgz", - "integrity": "sha512-sBkD+Xi9DtcChsI3L3u0+N0opgPYnCRPtGcQYrgXmR+hmt/fYfWAL0xRXYU8eWOdfuLgBe0YCW3AFtnRLagq/g==", - "requires": { - "chalk": "^4.0.0", - "jest-diff": "^29.7.0", - "jest-get-type": "^29.6.3", - "pretty-format": "^29.7.0" - }, - "dependencies": { - "ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "requires": { - "color-convert": "^2.0.1" - } - }, - "chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "requires": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" - }, - "has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==" - }, - "supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "requires": { - "has-flag": "^4.0.0" - } - } - } - }, "js-levenshtein": { "version": "1.1.6", "resolved": "https://registry.npmjs.org/js-levenshtein/-/js-levenshtein-1.1.6.tgz", @@ -4854,11 +3718,6 @@ "argparse": "^2.0.1" } }, - "jsep": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/jsep/-/jsep-1.4.0.tgz", - "integrity": "sha512-B7qPcEVE3NVkmSJbaYxvv4cHkVW7DQsZz13pUMrfS8z8Q/BuShN+gcTXrUlPiGqM2/t/EEaI030bpxMqY8gMlw==" - }, "json-parse-even-better-errors": { "version": "2.3.1", "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", @@ -4873,20 +3732,25 @@ "foreach": "^2.0.4" } }, + "json-schema-to-ts": { + "version": "2.7.2", + "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-2.7.2.tgz", + "integrity": "sha512-R1JfqKqbBR4qE8UyBR56Ms30LL62/nlhoz+1UkfI/VE7p54Awu919FZ6ZUPG8zIa3XB65usPJgr1ONVncUGSaQ==", + "requires": { + "@babel/runtime": "^7.18.3", + "@types/json-schema": "^7.0.9", + "ts-algebra": "^1.2.0" + } + }, "json-schema-traverse": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==" }, - "jsonpath-plus": { - "version": "10.3.0", - "resolved": "https://registry.npmjs.org/jsonpath-plus/-/jsonpath-plus-10.3.0.tgz", - "integrity": "sha512-8TNmfeTCk2Le33A3vRRwtuworG/L5RrgMvdjhKZxvyShO+mBu2fP50OWUjRLNtvw344DdDarFh9buFAZs5ujeA==", - "requires": { - "@jsep-plugin/assignment": "^1.3.0", - "@jsep-plugin/regex": "^1.0.4", - "jsep": "^1.4.0" - } + "jsonpath-rfc9535": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/jsonpath-rfc9535/-/jsonpath-rfc9535-1.3.0.tgz", + "integrity": "sha512-3jFHya7oZ45aDxIIdx+/zQARahHXxFSMWBkcBUldfXpLS9VCXDJyTKt35kQfEXLqh0K3Ixw/9xFnvcDStaxh7Q==" }, "jsonpointer": { "version": "5.0.1", @@ -4940,6 +3804,11 @@ "js-tokens": "^3.0.0 || ^4.0.0" } }, + "lru-cache": { + "version": "11.2.7", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz", + "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==" + }, "lunr": { "version": "2.3.9", "resolved": "https://registry.npmjs.org/lunr/-/lunr-2.3.9.tgz", @@ -4955,28 +3824,11 @@ "resolved": "https://registry.npmjs.org/marked/-/marked-4.3.0.tgz", "integrity": "sha512-PRsaiG84bK+AMvxziE/lCFss8juXjNaWzVbN5tXAm4XjeaS9NAHhop+PjQxz2A9h8Q4M/xGmzP8vqNwy6JeK0A==" }, - "math-intrinsics": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz", - "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==" - }, - "mime-db": { - "version": "1.52.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz", - "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==" - }, - "mime-types": { - "version": "2.1.35", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz", - "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==", - "requires": { - "mime-db": "1.52.0" - } - }, "minimatch": { "version": "3.1.4", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.4.tgz", "integrity": "sha512-twmL+S8+7yIsE9wsqgzU3E8/LumN3M3QELrBZ20OdmQ9jB2JvW5oZtBEmft84k/Gs5CG9mqtWc6Y9vW+JEzGxw==", + "dev": true, "requires": { "brace-expansion": "^1.1.7" } @@ -4986,6 +3838,11 @@ "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==" }, + "minipass": { + "version": "7.1.3", + "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz", + "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==" + }, "mkdirp": { "version": "0.5.6", "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", @@ -4998,15 +3855,14 @@ "mobx": { "version": "6.15.0", "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.0.tgz", - "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==", - "peer": true + "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==" }, "mobx-react": { - "version": "9.2.1", - "resolved": "https://registry.npmjs.org/mobx-react/-/mobx-react-9.2.1.tgz", - "integrity": "sha512-WJNNm0FB2n0Z0u+jS1QHmmWyV8l2WiAj8V8I/96kbUEN2YbYCoKW+hbbqKKRUBqElu0llxM7nWKehvRIkhBVJw==", + "version": "9.2.0", + "resolved": "https://registry.npmjs.org/mobx-react/-/mobx-react-9.2.0.tgz", + "integrity": "sha512-dkGWCx+S0/1mfiuFfHRH8D9cplmwhxOV5CkXMp38u6rQGG2Pv3FWYztS0M7ncR6TyPRQKaTG/pnitInoYE9Vrw==", "requires": { - "mobx-react-lite": "^4.1.1" + "mobx-react-lite": "^4.1.0" } }, "mobx-react-lite": { @@ -5078,11 +3934,6 @@ "validate-npm-package-license": "^3.0.1" } }, - "normalize-path": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/normalize-path/-/normalize-path-3.0.0.tgz", - "integrity": "sha512-6eZs5Ls3WtCisHWp9S2GUy8dqkpGi4BVSz3GaqiE6ezub0512ESztXUwUB6C6IKbQkY2Pnb/mD4WYojCRwcwLA==" - }, "npm-normalize-package-bin": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-1.0.1.tgz", @@ -5148,21 +3999,11 @@ "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=", + "dev": true, "requires": { "wrappy": "1" } }, - "open": { - "version": "10.1.0", - "resolved": "https://registry.npmjs.org/open/-/open-10.1.0.tgz", - "integrity": "sha512-mnkeQ1qP5Ue2wd+aivTD3NHd/lZ96Lu0jgf0pwktLPtx6cTZiH7tyeGRRHs0zX0rbrahXPnXlUnbeXyaBBuIaw==", - "requires": { - "default-browser": "^5.2.1", - "define-lazy-prop": "^3.0.0", - "is-inside-container": "^1.0.0", - "is-wsl": "^3.1.0" - } - }, "openapi-sampler": { "version": "1.7.2", "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.2.tgz", @@ -5213,7 +4054,8 @@ "path-is-absolute": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", - "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=" + "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=", + "dev": true }, "path-parse": { "version": "1.0.7", @@ -5221,6 +4063,15 @@ "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", "dev": true }, + "path-scurry": { + "version": "2.0.2", + "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz", + "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==", + "requires": { + "lru-cache": "^11.0.0", + "minipass": "^7.1.2" + } + }, "perfect-scrollbar": { "version": "1.5.6", "resolved": "https://registry.npmjs.org/perfect-scrollbar/-/perfect-scrollbar-1.5.6.tgz", @@ -5232,9 +4083,9 @@ "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==" }, "picomatch": { - "version": "2.3.2", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz", - "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==" + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", + "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==" }, "pluralize": { "version": "8.0.0", @@ -5264,23 +4115,6 @@ "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz", "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==" }, - "pretty-format": { - "version": "29.7.0", - "resolved": "https://registry.npmjs.org/pretty-format/-/pretty-format-29.7.0.tgz", - "integrity": "sha512-Pdlw/oPxN+aXdmM9R00JVC9WVFoCLTKJvDVLgmJ+qAffBMxsV85l/Lu7sNx4zSzPyoL2euImuEwHhOXdEgNFZQ==", - "requires": { - "@jest/schemas": "^29.6.3", - "ansi-styles": "^5.0.0", - "react-is": "^18.0.0" - }, - "dependencies": { - "ansi-styles": { - "version": "5.2.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-5.2.0.tgz", - "integrity": "sha512-Cxwpt2SfTzTtXcfOlzGEee8O+c+MmUgGrNiBcXnuWxuFJHe6a5Hz7qwhwe5OgaSYI0IJvkLqWX1ASG+cJOkEiA==" - } - } - }, "prismjs": { "version": "1.30.0", "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", @@ -5294,13 +4128,6 @@ "loose-envify": "^1.4.0", "object-assign": "^4.1.1", "react-is": "^16.13.1" - }, - "dependencies": { - "react-is": { - "version": "16.13.1", - "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", - "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==" - } } }, "protobufjs": { @@ -5349,14 +4176,14 @@ } }, "react-is": { - "version": "18.3.1", - "resolved": "https://registry.npmjs.org/react-is/-/react-is-18.3.1.tgz", - "integrity": "sha512-/LLMVyas0ljjAtoYiPqYiL8VWXzUUdThrmU5+n20DZv+a+ClRoevUzw5JxU+Ieh5/c87ytoTBV9G1FiKfNJdmg==" + "version": "16.13.1", + "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", + "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==" }, "react-tabs": { - "version": "6.1.0", - "resolved": "https://registry.npmjs.org/react-tabs/-/react-tabs-6.1.0.tgz", - "integrity": "sha512-6QtbTRDKM+jA/MZTTefvigNxo0zz+gnBTVFw2CFVvq+f2BuH0nF0vDLNClL045nuTAdOoK/IL1vTP0ZLX0DAyQ==", + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/react-tabs/-/react-tabs-6.1.1.tgz", + "integrity": "sha512-CPiuKoMFf89B7QlbFfdBD9XmUWiE3qudQputMVZB8GQvPJZRX/gqjDaDWOPDwGinEfpJKEuBCkGt83Tt4efeyA==", "requires": { "clsx": "^2.0.0", "prop-types": "^15.5.0" @@ -5411,18 +4238,10 @@ "once": "^1.3.0" } }, - "readdirp": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/readdirp/-/readdirp-3.6.0.tgz", - "integrity": "sha512-hOS089on8RduqdbhvQ5Z37A0ESjsqz6qnRcffsMU3495FuTdqSm+7bhJ29JvIOsBDEEnan5DPu9t3To9VRlMzA==", - "requires": { - "picomatch": "^2.2.1" - } - }, "redoc": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.5.0.tgz", - "integrity": "sha512-NpYsOZ1PD9qFdjbLVBZJWptqE+4Y6TkUuvEOqPUmoH7AKOmPcE+hYjotLxQNTqVoWL4z0T2uxILmcc8JGDci+Q==", + "version": "2.5.1", + "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.5.1.tgz", + "integrity": "sha512-LmqA+4A3CmhTllGG197F0arUpmChukAj9klfSdxNRemT9Hr07xXr7OGKu4PHzBs359sgrJ+4JwmOlM7nxLPGMg==", "requires": { "@redocly/openapi-core": "^1.4.0", "classnames": "^2.3.2", @@ -5433,7 +4252,7 @@ "lunr": "^2.3.9", "mark.js": "^8.11.1", "marked": "^4.3.0", - "mobx-react": "^9.1.1", + "mobx-react": "9.2.0", "openapi-sampler": "^1.5.0", "path-browserify": "^1.0.1", "perfect-scrollbar": "^1.5.5", @@ -5445,6 +4264,56 @@ "stickyfill": "^1.1.1", "swagger2openapi": "^7.0.8", "url-template": "^2.0.8" + }, + "dependencies": { + "@redocly/ajv": { + "version": "8.11.2", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.11.2.tgz", + "integrity": "sha512-io1JpnwtIcvojV7QKDUSIuMN/ikdOUd1ReEnUnMKGfDVridQZ31J0MmIuqwuRjWDZfmvr+Q0MqCcfHM2gTivOg==", + "requires": { + "fast-deep-equal": "^3.1.1", + "json-schema-traverse": "^1.0.0", + "require-from-string": "^2.0.2", + "uri-js-replace": "^1.0.1" + } + }, + "@redocly/config": { + "version": "0.22.0", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", + "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==" + }, + "@redocly/openapi-core": { + "version": "1.34.11", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", + "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", + "requires": { + "@redocly/ajv": "8.11.2", + "@redocly/config": "0.22.0", + "colorette": "1.4.0", + "https-proxy-agent": "7.0.6", + "js-levenshtein": "1.1.6", + "js-yaml": "4.1.1", + "minimatch": "5.1.9", + "pluralize": "8.0.0", + "yaml-ast-parser": "0.0.43" + } + }, + "brace-expansion": { + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", + "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", + "requires": { + "balanced-match": "^1.0.0" + } + }, + "minimatch": { + "version": "5.1.9", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", + "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", + "requires": { + "brace-expansion": "^2.0.1" + } + } } }, "reftools": { @@ -5473,11 +4342,6 @@ "supports-preserve-symlinks-flag": "^1.0.0" } }, - "run-applescript": { - "version": "7.1.0", - "resolved": "https://registry.npmjs.org/run-applescript/-/run-applescript-7.1.0.tgz", - "integrity": "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q==" - }, "safe-buffer": { "version": "5.2.1", "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", @@ -5495,9 +4359,9 @@ "dev": true }, "set-cookie-parser": { - "version": "2.7.1", - "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.1.tgz", - "integrity": "sha512-IOc8uWeOZgnb3ptbCURJWNjWUPcO3ZnTTdzsurqERrP6nPyv+paC55vJM0LpOlT2ne+Ix+9+CRG1MNLlyZ4GjQ==" + "version": "2.7.2", + "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", + "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==" }, "shallowequal": { "version": "1.1.0", @@ -5735,14 +4599,6 @@ "yargs": "^17.0.1" } }, - "to-regex-range": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", - "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", - "requires": { - "is-number": "^7.0.0" - } - }, "tr46": { "version": "0.0.3", "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", @@ -5754,26 +4610,31 @@ "integrity": "sha512-1m4RA7xVAJrSGrrXGs0L3YTwyvBs2S8PbRHaLZAkFw7JR8oIFwYtysxlBZhYIa7xSyiYJKZ3iGrrk55cGA3i9A==", "dev": true }, + "ts-algebra": { + "version": "1.2.2", + "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-1.2.2.tgz", + "integrity": "sha512-kloPhf1hq3JbCPOTYoOWDKxebWjNb2o/LKnNfkWhxVVisFFmMJPPdJeGoGmM+iRLyoXAR61e08Pb+vUXINg8aA==" + }, "tslib": { "version": "2.8.1", "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==" }, - "typedarray": { - "version": "0.0.6", - "resolved": "https://registry.npmjs.org/typedarray/-/typedarray-0.0.6.tgz", - "integrity": "sha512-/aCDEGatGvZ2BIk+HmLf4ifCJFwvKFNb9/JeZPMulfgFracn9QFcAf5GO8B/mweUjSoblS5In0cWhqpfs/5PQA==" - }, "uglify-js": { "version": "3.19.3", "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", "optional": true }, + "ulid": { + "version": "3.0.2", + "resolved": "https://registry.npmjs.org/ulid/-/ulid-3.0.2.tgz", + "integrity": "sha512-yu26mwteFYzBAot7KVMqFGCVpsF6g8wXfJzQUHvu1no3+rRRSFcSV2nKeYvNPLD2J4b08jYBDhHUjeH0ygIl9w==" + }, "undici": { - "version": "6.24.1", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.1.tgz", - "integrity": "sha512-sC+b0tB1whOCzbtlx20fx3WgCXwkW627p4EA9uM+/tNNPkSS+eSEld6pAs9nDv7WbY1UUljBMYPtu9BCOrCWKA==" + "version": "6.24.0", + "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.0.tgz", + "integrity": "sha512-lVLNosgqo5EkGqh5XUDhGfsMSoO8K0BAN0TyJLvwNRSl4xWGZlCVYsAIpa/OpA3TvmnM01GWcoKmc3ZWo5wKKA==" }, "undici-types": { "version": "7.18.2", @@ -5872,7 +4733,8 @@ "wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", - "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=" + "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=", + "dev": true }, "ws": { "version": "7.5.10", diff --git a/package.json b/package.json index 3a48d7285..d2ad63ee1 100644 --- a/package.json +++ b/package.json @@ -12,10 +12,13 @@ "license": "MIT", "homepage": "https://github.com/NHSDigital/e-referrals-service-api", "dependencies": { - "@redocly/cli": "^1.34.5" + "@redocly/cli": "^2.25.3" }, "devDependencies": { "license-checker": "^25.0.1", "minimist": "^1.2.8" + }, + "overrides": { + "handlebars": "^4.7.9" } } diff --git a/redocly.yaml b/redocly.yaml index fa3880bd9..1af24940b 100644 --- a/redocly.yaml +++ b/redocly.yaml @@ -3,5 +3,4 @@ extends: rules: no-invalid-media-type-examples: severity: off - info-license-url: off tag-description: off diff --git a/specification/components/stu3/schemas/endpoints/a020-upload-file-to-document-store.yaml b/specification/components/stu3/schemas/endpoints/a020-upload-file-to-document-store.yaml index 3cf29ec4a..73603531f 100644 --- a/specification/components/stu3/schemas/endpoints/a020-upload-file-to-document-store.yaml +++ b/specification/components/stu3/schemas/endpoints/a020-upload-file-to-document-store.yaml @@ -81,7 +81,49 @@ parameters: requestBody: required: true content: - $ref: '../file/FileContentTypeSchemaUpload.yaml' + text/plain: + schema: + $ref: '../file/StringBinarySchema.yaml' + example: 'This is some example text.' + application/pdf: + schema: + $ref: '../file/StringBinarySchema.yaml' + text/xml: + schema: + $ref: '../file/StringBinarySchema.yaml' + text/rtf: + schema: + $ref: '../file/StringBinarySchema.yaml' + audio/basic: + schema: + $ref: '../file/StringBinarySchema.yaml' + audio/mpeg: + schema: + $ref: '../file/StringBinarySchema.yaml' + image/png: + schema: + $ref: '../file/StringBinarySchema.yaml' + image/gif: + schema: + $ref: '../file/StringBinarySchema.yaml' + image/jpeg: + schema: + $ref: '../file/StringBinarySchema.yaml' + image/tiff: + schema: + $ref: '../file/StringBinarySchema.yaml' + video/mpeg: + schema: + $ref: '../file/StringBinarySchema.yaml' + application/msword: + schema: + $ref: '../file/StringBinarySchema.yaml' + application/vnd.openxmlformats-officedocument.wordprocessingml.document: + schema: + $ref: '../file/StringBinarySchema.yaml' + application/dicom: + schema: + $ref: '../file/StringBinarySchema.yaml' responses: '201': $ref: '../responses/uploadFileToDocumentStore/201Response.yaml' diff --git a/specification/components/stu3/schemas/file/FileContentTypeSchemaDownload.yaml b/specification/components/stu3/schemas/file/FileContentTypeSchemaDownload.yaml deleted file mode 100644 index 7e7890b39..000000000 --- a/specification/components/stu3/schemas/file/FileContentTypeSchemaDownload.yaml +++ /dev/null @@ -1,46 +0,0 @@ -text/plain: - schema: - $ref: 'StringBinarySchema.yaml' - example: 'This is some example text.' -text/html: - schema: - $ref: 'StringBinarySchema.yaml' -application/pdf: - schema: - $ref: 'StringBinarySchema.yaml' -text/xml: - schema: - $ref: 'StringBinarySchema.yaml' -text/rtf: - schema: - $ref: 'StringBinarySchema.yaml' -audio/basic: - schema: - $ref: 'StringBinarySchema.yaml' -audio/mpeg: - schema: - $ref: 'StringBinarySchema.yaml' -image/png: - schema: - $ref: 'StringBinarySchema.yaml' -image/gif: - schema: - $ref: 'StringBinarySchema.yaml' -image/jpeg: - schema: - $ref: 'StringBinarySchema.yaml' -image/tiff: - schema: - $ref: 'StringBinarySchema.yaml' -video/mpeg: - schema: - $ref: 'StringBinarySchema.yaml' -application/msword: - schema: - $ref: 'StringBinarySchema.yaml' -application/vnd.openxmlformats-officedocument.wordprocessingml.document: - schema: - $ref: 'StringBinarySchema.yaml' -application/dicom: - schema: - $ref: 'StringBinarySchema.yaml' diff --git a/specification/components/stu3/schemas/file/FileContentTypeSchemaUpload.yaml b/specification/components/stu3/schemas/file/FileContentTypeSchemaUpload.yaml deleted file mode 100644 index ae314062a..000000000 --- a/specification/components/stu3/schemas/file/FileContentTypeSchemaUpload.yaml +++ /dev/null @@ -1,43 +0,0 @@ -text/plain: - schema: - $ref: 'StringBinarySchema.yaml' - example: 'This is some example text.' -application/pdf: - schema: - $ref: 'StringBinarySchema.yaml' -text/xml: - schema: - $ref: 'StringBinarySchema.yaml' -text/rtf: - schema: - $ref: 'StringBinarySchema.yaml' -audio/basic: - schema: - $ref: 'StringBinarySchema.yaml' -audio/mpeg: - schema: - $ref: 'StringBinarySchema.yaml' -image/png: - schema: - $ref: 'StringBinarySchema.yaml' -image/gif: - schema: - $ref: 'StringBinarySchema.yaml' -image/jpeg: - schema: - $ref: 'StringBinarySchema.yaml' -image/tiff: - schema: - $ref: 'StringBinarySchema.yaml' -video/mpeg: - schema: - $ref: 'StringBinarySchema.yaml' -application/msword: - schema: - $ref: 'StringBinarySchema.yaml' -application/vnd.openxmlformats-officedocument.wordprocessingml.document: - schema: - $ref: 'StringBinarySchema.yaml' -application/dicom: - schema: - $ref: 'StringBinarySchema.yaml' diff --git a/specification/components/stu3/schemas/responses/retrieveAttachment/200Response.yaml b/specification/components/stu3/schemas/responses/retrieveAttachment/200Response.yaml index 76c242c6e..38ed4aa1b 100644 --- a/specification/components/stu3/schemas/responses/retrieveAttachment/200Response.yaml +++ b/specification/components/stu3/schemas/responses/retrieveAttachment/200Response.yaml @@ -11,4 +11,49 @@ headers: Content-Type: $ref: '../../headers/response/ContentTypeAttachmentsDownload.yaml' content: - $ref: '../../file/FileContentTypeSchemaDownload.yaml' + text/plain: + schema: + $ref: '../../file/StringBinarySchema.yaml' + example: 'This is some example text.' + text/html: + schema: + $ref: '../../file/StringBinarySchema.yaml' + application/pdf: + schema: + $ref: '../../file/StringBinarySchema.yaml' + text/xml: + schema: + $ref: '../../file/StringBinarySchema.yaml' + text/rtf: + schema: + $ref: '../../file/StringBinarySchema.yaml' + audio/basic: + schema: + $ref: '../../file/StringBinarySchema.yaml' + audio/mpeg: + schema: + $ref: '../../file/StringBinarySchema.yaml' + image/png: + schema: + $ref: '../../file/StringBinarySchema.yaml' + image/gif: + schema: + $ref: '../../file/StringBinarySchema.yaml' + image/jpeg: + schema: + $ref: '../../file/StringBinarySchema.yaml' + image/tiff: + schema: + $ref: '../../file/StringBinarySchema.yaml' + video/mpeg: + schema: + $ref: '../../file/StringBinarySchema.yaml' + application/msword: + schema: + $ref: '../../file/StringBinarySchema.yaml' + application/vnd.openxmlformats-officedocument.wordprocessingml.document: + schema: + $ref: '../../file/StringBinarySchema.yaml' + application/dicom: + schema: + $ref: '../../file/StringBinarySchema.yaml' diff --git a/test-output.json b/test-output.json new file mode 100644 index 000000000..296c6b43e --- /dev/null +++ b/test-output.json @@ -0,0 +1,100528 @@ +[1] redocly.yaml:6:3 at #/rules/info-license-url + +Property `info-license-url` is not expected here. + +4 | no-invalid-media-type-examples: +5 | severity: off +6 | info-license-url: off + | ^^^^^^^^^^^^^^^^ +7 | tag-description: off +8 | + +Warning was generated by the configuration struct rule. + + +{ + "openapi": "3.0.0", + "info": { + "version": "0.0.1", + "title": "e-Referrals Service", + "description": "## Overview\nUse this API to create paperless referrals from primary to secondary care with the [e-Referral Service (e-RS)](https://digital.nhs.uk/services/e-referral-service).\n\nFor an overview of how you can plan and prepare for your integration with e-RS, see our [API onboarding guide](https://digital.nhs.uk/services/e-referral-service/api).\n\n**As a primary care referrer, you can:**\n\n -\tcreate a new e-referral\n - search for relevant patient services to create a shortlist\n -\taccess existing e-referrals\n -\tcreate a triage request for the Referral Assessment Service (RAS)\n -\tupload and manage a patient letter or attachments, linking them to a referral\n -\tretrieve appointment slots and book appointments\n -\tdefer a booking to a provider if an appointment slot is unavailable\n - create a new advice and guidance request\n\n**As a secondary care provider, you can:**\n\n -\taccess referrals as a worklist\n -\tretrieve non-clinical information (meta-data) about the referral\n -\tretrieve attachments which are linked to a referral or triage (RAS) request\n -\tretrieve clinical information which has been provided by a referrer\n -\taccept or reject a referral request\n -\tretrieve Advice & Guidance (A&G) conversations and send responses\n -\tconvert Advice & Guidance (A&G) conversations into a referral\n - cancel a referral\n\n**You cannot use this API to:**\n\n -\tget patient details - instead, use the [[HYPERLINK_PDS]]\n\n**You can access the following data:**\n\n -\treferral attachments\n -\treferral letters\n -\tappointment slots\n -\tworklists for referral requests\n -\tworklists for triage (RAS) requests\n -\tworklists for Advice and Guidance (A&G) requests\n -\tconversation histories for Advice and Guidance (A&G) requests\n\n
\n
\n
\n
\n \n \"\"\n \n
\n
\n
\n
\n

To discover the most common use cases, see our Building Healthcare Software guides.

\n
\n
\n
\n
\n\n### Access modes\n\nThis API has two access modes:\n\n| Access mode | Authentication via | Functions | Availability |\n| ----------------------------- | -------------------------- | ----------------------- | ------------------------------- |\n| Application-restricted,
unattended access | [[HYPERLINK_SIGNED_JWT]] |
  • [[HYPERLINK_A004]]
  • [[HYPERLINK_A005]]
  • [[HYPERLINK_A007]]
  • [[HYPERLINK_A008]]
  • [[HYPERLINK_A013]]
  • [[HYPERLINK_A024]]
  • [[HYPERLINK_A025]]
  • [[HYPERLINK_A028]]
  • [[HYPERLINK_A029]]
  • [[HYPERLINK_A033]]
  • [[HYPERLINK_A035]]
  • [[HYPERLINK_A036]]
  • [[HYPERLINK_A037]]
  • [[HYPERLINK_A042]]
  • [[HYPERLINK_A043]]
| [[HYPERLINK_PRODUCTION]] |\n| Healthcare worker,
user-restricted access | [[HYPERLINK_CIS_AUTH_SHORT]] | All Endpoints | [[HYPERLINK_PRODUCTION]] |\n\n##### Application-restricted, unattended access\n\nThis access mode has been introduced to allow a Partner application which has been [registered with us](https://portal.developer.nhs.uk/create-a-developer-account) and [authenticated via signed JWT](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/application-restricted-restful-apis-signed-jwt-authentication) to interact with a subset of e-RS FHIR API endpoints in an unattended and read-only fashion.\nApplication-restricted, unattended access should only be used when authenticating a human user (for example via smartcard) is not possible.\n\nWrite operations are currently supported for specific use cases via:\n- [[HYPERLINK_A028]]\n- [[HYPERLINK_A013]]\n- [[HYPERLINK_A036]]\n\nYou will be required to submit your use case for review when using these endpoints via application-restricted, unattended access.\n\n##### Healthcare worker, user-restricted access\n\nThis access mode allows Partner applications to access e-RS FHIR API endpoints by authenticating users with [[HYPERLINK_CIS_AUTH_LONG]].\n\nThis access mode must be used for writing changes (such as Create Referral).\n\n## Who can use this API\n\nYou can use this API if you are a software developer wishing to interact with the e-referrals service (e-RS) data, for use in a professional, clinical setting. \n\nTo use this API you must:\n\n -\thave justification for doing so\n -\t[register with us](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1-design#1-8-register-with-us)\n -\tensure you have a [valid use case](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1-design#1-2-validate-your-use-case) before you go too far with your development\n -\t[assure](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-3-assure) your solution before we grant access to live data\n\n## Related APIs\n\n[HL7 V3 API](https://digital.nhs.uk/developer/api-catalogue/e-referral-service-hl7-v3) - this API allows you to manage appointment slots for a Patient Administration System (PAS). \n\n\n## API status and roadmap\n\n### This API has two access modes:\n - Application-restricted, unattended access\n - Healthcare worker, user-restricted access\n\n### Application-restricted, unattended access\n\nThis access mode is [[HYPERLINK_PRODUCTION]], meaning:\n - we avoid making routine [breaking changes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy#breaking-changes), except in exceptional circumstances\n - if we need to deprecate an endpoint, we will give advance notice on our [board](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/deprecation-notices). Our [sunsetting page](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy) details our deprecation and retirement policy.\n \n### Healthcare worker, user-restricted access\n\nThis access mode is [[HYPERLINK_PRODUCTION]], meaning:\n - we avoid making routine [breaking changes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy#breaking-changes), except in exceptional circumstances\n - if we need to deprecate an endpoint, we will give advance notice on our [board](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/deprecation-notices). Our [sunsetting page](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy) details our deprecation and retirement policy.\n\n### Roadmap\n\nVisit our [roadmap page](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/roadmap) for details of what we are working on.\n\nTo suggest, comment or vote on features for this API, see our [interactive product backlog](https://portal.productboard.com/qhpkcqgctqtk3ujk8jyoajp8/tabs/4-new-requests).\n\n## Service level\nThis API is a gold service, meaning it is operational and supported 24 hours a day, 365 days a year.\n\nFor more details, see [service levels](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#service-levels).\n\n## Technology\n\nThis API is primarily [RESTful](https://digital.nhs.uk/developer/guides-and-documentation/api-technologies-at-nhs-digital#basic-rest) \nand based on [FHIR](https://digital.nhs.uk/developer/guides-and-documentation/api-technologies-at-nhs-digital#fhir) global standards for health care data exchange.\n\nThis API supports FHIR STU3 and FHIR R4.\n\n### FHIR STU3\n\nThe e-RS FHIR STU3 API is built against the set of profiles called [CareConnect](https://nhsconnect.github.io/CareConnectAPI/).\n\n### FHIR R4\n\nThe e-RS FHIR R4 API is built alongside the [NHS England FHIR Implementation Guide](https://simplifier.net/guide/nhsdigital), which is built on top of [FHIR UK Core](https://digital.nhs.uk/services/fhir-uk-core). The canonical URLs listed in the schema can be resolved with [https://simplifier.net/resolve](https://simplifier.net/resolve).\n\n## Network access\n\nThis API is available on the internet and, indirectly, on the [Health and Social Care Network (HSCN)](https://digital.nhs.uk/services/health-and-social-care-network).\n\nTo use this API with NHS smartcards you do need an HSCN connection, although internet-facing alternatives are available.\n\nFor more details see [Network access for APIs](https://digital.nhs.uk/developer/guides-and-documentation/network-access-for-apis).\n\n\n## Security and authorisation\n\nThis API has two access modes:\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n### Application-restricted, unattended access\n\nThis access mode is [application-restricted](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#application-restricted-apis), meaning we authenticate the calling application but not the end user.\n\nYou can only use this access mode when authenticating a human user (for example via smartcard) is not possible.\n\nWrite operations are currently only supported by [[HYPERLINK_A028]] for non-clinical use cases. You will be required to submit your use case for review when using this endpoint via application-restricted, unattended access.\n\nTo use this access mode, use the following security pattern:\n- [Application-restricted RESTful API - signed JWT authentication](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/application-restricted-restful-apis-signed-jwt-authentication)\n\n### Healthcare worker, user-restricted access\n\nThis access mode is [user-restricted](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis), meaning an end user must be present, authenticated and authorised.\n\nThe end user must be:\n- present\n- a healthcare worker\n- strongly authenticated and authorised by [[HYPERLINK_CIS_AUTH_LONG]]\n\nIn order to successfully authenticate with CIS2, the NHS e-Referral Service requires end users to be authenticated to the following standards:\n - an [Identity Assurance Level (IAL)](https://digital.nhs.uk/services/care-identity-service/applications-and-services/cis2-authentication/guidance-for-developers/detailed-guidance/scopes-and-claims#claims ) of IAL3\n - an [Authenticator Assurance Level (AAL)](https://digital.nhs.uk/services/care-identity-service/applications-and-services/cis2-authentication/guidance-for-developers/detailed-guidance/acr-values#authentication-methods) of AAL2 or AAL3\n\nTo use this access mode, use one of the following security patterns:\n- [user-restricted RESTful API - using NHS CIS2 - combined authentication and authorisation](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/user-restricted-restful-apis-nhs-cis2-combined-authentication-and-authorisation)\n- [user-restricted RESTful API - using NHS CIS2 - separate authentication and authorisation](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/user-restricted-restful-apis-nhs-cis2-separate-authentication-and-authorisation)\n\nWe strongly recommend the use of separate authentication and authorisation. This mode will provide you access to the healthcare workers identity, allowing you to reuse it across multiple applications such as PDS.\n\nYou can [learn more](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1.4---select-your-authentication-level#1-access-modes) about each access mode option on our onboarding guide.\n\n#### Role and Organisation Validation\nFor most e-RS endpoints requests are made in the context of a specific authorised e-RS Role at a specific Organisation for the authenticated user. \n\nThe e-RS Role is supplied to the endpoint via the `NHSD-eRS-Business-Function` request header. \n\nThe Organisation is supplied to the endpoint via the `NHSD-End-User-Organisation-ODS` request header. \n\nSuitable values for these request headers can be obtained from the Practitioner Role Bundle returned by [[HYPERLINK_A030]].\n\n#### On Behalf Of User\nIf the `SERVICE_PROVIDER_CLINICIAN_ADMIN` role is used then the User ID of the Service Provider Clinician that the Admin is acting on behalf of must be supplied via the `NHSD-eRS-On-Behalf-Of-User-ID` header.\n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC).\n\n## Environments and testing\n\n| Environment | Base URL |\n| ----------------- | ---------------------------------------------------------------------- |\n| Sandbox | `https://sandbox.api.service.nhs.uk/referrals/FHIR` |\n| Integration test | `https://int.api.service.nhs.uk/referrals/FHIR` |\n| Production | `https://api.service.nhs.uk/referrals/FHIR` |\n\n### Sandbox testing\n\nOur [sandbox](https://digital.nhs.uk/developer/guides-and-documentation/testing#sandbox-testing) environment:\n-\tis for developer education and early testing\n-\tonly covers a limited set of scenarios\n-\tis stateless, so does not actually persist any updates\n-\tis open access, so does not allow you to test authorisation\n\nTry out the sandbox using our 'Try this API' feature, see the documentation for each endpoint.\n\nThe sandbox will only respond to an input which exactly matches one of the examples provided; it is otherwise stateless.\n\n### Integration testing\n\nOur [integration test](https://digital.nhs.uk/developer/guides-and-documentation/testing#integration-testing-with-our-restful-apis) environment:\n -\tis where the majority of your integration efforts will take place\n - is where we conduct witness testing for your application\n -\tis stateful, so data will be persisted\n\n\n## Onboarding\n\nYou need to get your software approved by us before you can go live with this API. We call this onboarding. The onboarding process can sometimes be quite long, so it's worth planning well ahead.\n\nWe use the Supplier Conformance Assessment List (SCAL) process. [Learn more](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1-design#1-7-learn-how-to-onboard) about onboarding.\n\n## Errors\nWe use standard HTTP status codes to show whether an API request succeeded or not. They are usually in the range:\n* 200 to 299 if it succeeded, including code 202 if it was accepted by an API that needs to wait for further action\n* 400 to 499 if it failed because of a client error by your application\n* 500 to 599 if it failed because of an error on our server\n\nErrors specific to each API are shown in the Endpoints section, under Response. See our [reference guide](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#http-status-codes) for more on errors.\n", + "contact": { + "url": "https://digital.nhs.uk/developer/help-and-support", + "email": "api.management@nhs.net" + }, + "license": { + "name": "MIT" + } + }, + "servers": [ + { + "url": "https://sandbox.api.service.nhs.uk/referrals/FHIR", + "description": "Sandbox environment." + }, + { + "url": "https://int.api.service.nhs.uk/referrals/FHIR", + "description": "Integration test environment." + }, + { + "url": "https://api.service.nhs.uk/referrals/FHIR", + "description": "Production environment. Not yet available." + } + ], + "tags": [ + { + "name": "Retrieve user information" + }, + { + "name": "Refer patient" + }, + { + "name": "Arrange appointment" + }, + { + "name": "Arrange triage" + }, + { + "name": "Request advice" + }, + { + "name": "Retrieve healthcare service information" + }, + { + "name": "Change appointment" + }, + { + "name": "Manage referral" + }, + { + "name": "Retrieve clinical information" + }, + { + "name": "Review referral requests" + }, + { + "name": "Review advice and guidance requests" + } + ], + "paths": { + "/STU3/CodeSystem/{codeSystemType}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve a list of reference data codes along with the user-friendly display values used in the e-RS Professional Application.\n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider or Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Use case\nAs an authenticated user or application\n\nI need to retrieve e-RS reference data\n\nSo I can use it with other endpoints or display the reference data in a user-friendly format to my users.\n\n## Related endpoints\nReference data may be needed for other endpoints, for example when including Specialty and Clinic Type reference data to:\n- find services that meet the referral needs of a patient using [[HYPERLINK_A010]], and\n- create a referral using [[HYPERLINK_A011]]\n\nYou can use the Priority reference data to calculate when a patient can expect to be contacted by the service. \n\nThis is important because when a patient's appointment is deferred to a service to book, the patient may be informed of the date by which they can expect to be contacted. \nSimilarly, in the case of a triage service, a letter may inform the patient of the date by which they can expect to be contacted.\n\nYou can calculate this date by:\n\n1. Obtaining the current priority of the referral (via [[HYPERLINK_A005]]) and its associated \"deferToProviderContactDays\" (for deferred-to services) or \"triageContactDays\" (for triage services). These represent the number of \"working days\" and do not include weekends\n2. Obtaining the datetime of the appointment resource, e.g. \"created\" : \"2021-05-06T11:21:45.652Z\"\n3. Adding the \"working days\" to the datetime of the appointment resource\n\n For example:\n\n1. Given a referral with a priority of `TWO_WEEK_WAIT` and a \"deferToProviderContactDays\" of \"2\" for priority `TWO_WEEK_WAIT`\n2. If the appointment was created on Monday 03/01/2022 for a deferred-to service \n3. The calculated date when a patient can expect to be contacted by the service would be on or before 05/01/2022\n\nNote that the \"deferToProviderContactDays\" and \"triageContactDays\" values are dynamic, and may change independently from one another, so the above calculation is for illustration purposes only.\n\nYou may also wish to present the user-friendly names for the reference data, for example when viewing the referral using [[HYPERLINK_A005]] and [[HYPERLINK_A038]].\n\nDocumentation for other endpoints will reference this endpoint, where specific reference data is required.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request | Response |\n| --------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------------- |\n| Retrieve speciality reference data | `codeSystemType`=`SPECIALTY` | Specialty details |\n| Retrieve clinic type reference data | `codeSystemType`=`CLINIC-TYPE` | Clinic type details |\n| Retrieve appointment cancellation reason reference data | `codeSystemType`=`APPOINTMENT-CANCELLATION-REASON` | Appointment reason type details |\n| Retrieve referral cancellation reason reference data | `codeSystemType`=`REFERRAL-CANCELLATION-REASON` | ReferralRequest reason type details |\n| Retrieve appointment non-attendance reason reference data | `codeSystemType`=`APPOINTMENT-NON-ATTENDANCE-REASON` | Appointment non-attendance reason details |\n| Retrieve priority reference data | `codeSystemType`=`PRIORITY` | Priority details |\n", + "summary": "Retrieve reference data (A004, FHIR STU3)", + "operationId": "a004-retrieve-reference-data", + "tags": [ + "Refer patient", + "Request advice" + ], + "parameters": [ + { + "name": "codeSystemType", + "in": "path", + "description": "The requested code system\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "SPECIALTY", + "APPOINTMENT-CANCELLATION-REASON", + "CLINIC-TYPE", + "REFERRAL-CANCELLATION-REASON", + "APPOINTMENT-NON-ATTENDANCE-REASON", + "PRIORITY" + ], + "example": "SPECIALTY" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "e-RS Reference Data", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "url", + "name", + "status", + "date", + "description", + "content", + "property", + "concept" + ], + "properties": { + "id": { + "title": "Identifier of this code system", + "type": "string", + "enum": [ + "SPECIALTY", + "APPOINTMENT-CANCELLATION-REASON", + "CLINIC-TYPE", + "REFERRAL-CANCELLATION-REASON", + "APPOINTMENT-NON-ATTENDANCE-REASON", + "PRIORITY" + ], + "example": "SPECIALTY" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/StructureDefinition/shareablecodesystem", + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Specialty-CodeSystem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Specialty-CodeSystem-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "CodeSystem" + ], + "example": "CodeSystem" + }, + "url": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "name": { + "title": "Description of the code system", + "type": "string", + "enum": [ + "e-RS Appointment Cancellation Reason", + "e-RS Specialty", + "e-RS Clinic Type", + "e-RS ReferralRequest Cancellation Reason", + "e-RS Appointment Non-attendance Reason", + "e-RS Priority" + ], + "example": "e-RS Specialty" + }, + "status": { + "type": "string", + "enum": [ + "active" + ], + "example": "active" + }, + "date": { + "type": "string", + "format": "date-time" + }, + "publisher": { + "type": "string", + "enum": [ + "e-Referral Service" + ], + "example": "e-Referral Service" + }, + "description": { + "type": "string", + "example": "e-RS Specialty" + }, + "copyright": { + "type": "string", + "example": "Copyright (c) 2016 HL7 UK" + }, + "content": { + "type": "string", + "enum": [ + "complete" + ], + "example": "complete" + }, + "property": { + "title": "Code System Properties", + "description": "\nSome properties are only returned for certain code systems\n \n| Property | Code System |\n| -----------------------------------------| ------------------------------------------------------------- |\n| EffectiveFrom | All Code Systems |\n| EffectiveTo | All Code Systems |\n| Specialty | CLINIC-TYPE |\n| AppointmentBookingCancellationReasonType | APPOINTMENT-CANCELLATION-REASON |\n| WillCancelWholeRequest | APPOINTMENT-CANCELLATION-REASON |\n| Usage | APPOINTMENT-CANCELLATION-REASON |\n| CommentIsMandatory | APPOINTMENT-CANCELLATION-REASON / REFERRAL-CANCELLATION-REASON |\n| BusinessFunction | APPOINTMENT-CANCELLATION-REASON / REFERRAL-CANCELLATION-REASON |\n| AppointmentRequestCancellationReasonType | REFERRAL-CANCELLATION-REASON |\n| CanCancelAppointment | REFERRAL-CANCELLATION-REASON |\n| ReferrerUsage | REFERRAL-CANCELLATION-REASON |\n| DeferToProviderContactDays | PRIORITY |\n| TriageContactDays | PRIORITY |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "Effective from date", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "effectiveFrom" + ], + "example": "effectiveFrom" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveFrom" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveFrom" + }, + "type": { + "type": "string", + "enum": [ + "dateTime" + ], + "example": "dateTime" + } + } + }, + { + "title": "Effective to date", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "effectiveTo" + ], + "example": "effectiveTo" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveTo" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveTo" + }, + "type": { + "type": "string", + "enum": [ + "dateTime" + ], + "example": "dateTime" + } + } + }, + { + "title": "Specialty", + "description": "This will only be returned when codeSystemType is CLINIC-TYPE", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#specialty" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#specialty" + }, + "type": { + "type": "string", + "enum": [ + "Coding" + ], + "example": "Coding" + } + } + }, + { + "title": "Appointment Booking Cancellation Reason Type", + "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "appointmentBookingCancellationReasonType" + ], + "example": "appointmentBookingCancellationReasonType" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentBookingCancellationReasonType" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentBookingCancellationReasonType" + }, + "type": { + "type": "string", + "enum": [ + "Coding" + ], + "example": "Coding" + } + } + }, + { + "title": "Will Cancel Whole Request", + "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", + "type": "object", + "deprecated": true, + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "willCancelWholeRequest" + ], + "example": "willCancelWholeRequest" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#willCancelWholeRequest" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#willCancelWholeRequest" + }, + "type": { + "type": "string", + "enum": [ + "boolean" + ], + "example": "boolean" + } + } + }, + { + "title": "Usage", + "description": "Details how the current code system should be used", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "usage" + ], + "example": "usage" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#usage" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#usage" + }, + "type": { + "type": "string", + "enum": [ + "Coding" + ], + "example": "Coding" + } + } + }, + { + "title": "Comment Is Mandatory", + "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON or REFERRAL-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "commentIsMandatory" + ], + "example": "commentIsMandatory" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#commentIsMandatory" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#commentIsMandatory" + }, + "type": { + "type": "string", + "enum": [ + "boolean" + ], + "example": "boolean" + } + } + }, + { + "title": "BusinessFunction", + "description": "Details which Business functions are able to use the current code system", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "businessFunction" + ], + "example": "businessFunction" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#businessFunction" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#businessFunction" + }, + "type": { + "type": "string", + "enum": [ + "Coding" + ], + "example": "Coding" + } + } + }, + { + "title": "Appointment Request Cancellation Reason Type", + "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "appointmentRequestCancellationReasonType" + ], + "example": "appointmentRequestCancellationReasonType" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentRequestCancellationReasonType" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentRequestCancellationReasonType" + }, + "type": { + "type": "string", + "enum": [ + "Coding" + ], + "example": "Coding" + } + } + }, + { + "title": "CanCancelAppointment", + "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "canCancelAppointment" + ], + "example": "canCancelAppointment" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#canCancelAppointment" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#canCancelAppointment" + }, + "type": { + "type": "string", + "enum": [ + "boolean" + ], + "example": "boolean" + } + } + }, + { + "title": "ReferrerUsage", + "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "referrerUsage" + ], + "example": "referrerUsage" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#referrerUsage" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#referrerUsage" + }, + "type": { + "type": "string", + "enum": [ + "Coding" + ], + "example": "Coding" + } + } + }, + { + "title": "Defer to Provider Contact Days", + "description": "This will only be returned when codeSystemType is PRIORITY", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "deferToProviderContactDays" + ], + "example": "deferToProviderContactDays" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#deferToProviderContactDays" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#deferToProviderContactDays" + }, + "type": { + "type": "string", + "enum": [ + "integer" + ], + "example": "integer" + } + } + }, + { + "title": "Triage Contact Days", + "description": "This will only be returned when codeSystemType is PRIORITY", + "type": "object", + "required": [ + "code", + "uri", + "type" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "triageContactDays" + ], + "example": "triageContactDays" + }, + "uri": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#triageContactDays" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#triageContactDays" + }, + "type": { + "type": "string", + "enum": [ + "integer" + ], + "example": "integer" + } + } + } + ] + } + }, + "concept": { + "title": "Details of the code system", + "type": "array", + "items": { + "type": "object", + "required": [ + "code", + "display", + "property" + ], + "properties": { + "extension": { + "title": "Effective Date Range Extensions", + "type": "array", + "nullable": true, + "items": { + "anyOf": [ + { + "title": "Extension-eRS-EffectivefromDate", + "description": "Extension to supply the effective From Date, this will only be returned for specialty", + "type": "object", + "required": [ + "url", + "valueDate" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivefromDate-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivefromDate-1" + }, + "valueDate": { + "type": "string", + "format": "date" + } + } + }, + { + "title": "Extension-eRS-EffectivetoDate", + "description": "Extension to supply the effective To Date, this will only be returned for specialty", + "type": "object", + "required": [ + "url", + "valueDate" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivetoDate-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivetoDate-1" + }, + "valueDate": { + "type": "string", + "format": "date" + } + } + } + ] + } + }, + "code": { + "title": "Value of the code system", + "description": "\n| Code System | Example Value |\n| ------------------------------------- | ----------------------------- |\n| Specialty | UROLOGY |\n| Clinic Type | GENERAL_UROLOGY |\n| Appointment Cancellation Reason | SERVICE_INAPPROPRIATE |\n| Referral Cancellation Reason | INTEND_PRIVATE |\n| Appointment Non-attendance Reason | PATIENT_ILL |\n| Priority | ROUTINE |\n", + "type": "string" + }, + "display": { + "title": "Display value of the code system", + "description": "\n| Code System | Example Display Value |\n| ------------------------------------- | ----------------------------------- |\n| Specialty | Urology |\n| Clinic Type | General Urology |\n| Appointment Cancellation Reason | Inappropriate service |\n| Referral Cancellation Reason | Patient will go to a private clinic |\n| Appointment Non-attendance Reason | Patient ill |\n| Priority | Routine |\n", + "type": "string" + }, + "property": { + "description": "\nSome properties are only returned for certain code systems\n\n| Property | Code System |\n| -----------------------------------------| ----------------------------------------------------------- |\n| EffectiveFrom | All Code Systems |\n| EffectiveTo | All Code Systems |\n| Specialty | CLINIC-TYPE |\n| AppointmentBookingCancellationReasonType | APPOINTMENT-CANCELLATION-REASON |\n| WillCancelWholeRequest | APPOINTMENT-CANCELLATION-REASON |\n| Usage | APPOINTMENT-CANCELLATION-REASON |\n| CommentIsMandatory | APPOINTMENT-CANCELLATION-REASON/REFERRAL-CANCELLATION-REASON |\n| businessFunction | APPOINTMENT-CANCELLATION-REASON/REFERRAL-CANCELLATION-REASON |\n| AppointmentRequestCancellationReasonType | REFERRAL-CANCELLATION-REASON |\n| CanCancelAppointment | REFERRAL-CANCELLATION-REASON |\n| RequestCancellationReferrerUsage | REFERRAL-CANCELLATION-REASON |\n| DeferToProviderContactDays | PRIORITY |\n| TriageContactDays | PRIORITY |\n", + "type": "array", + "nullable": true, + "items": { + "anyOf": [ + { + "title": "Will cancel whole request value", + "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", + "type": "object", + "deprecated": true, + "required": [ + "code", + "valueBoolean" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "willCancelWholeRequest" + ] + }, + "valueBoolean": { + "type": "boolean" + } + } + }, + { + "title": "Effective from date", + "type": "object", + "required": [ + "code", + "valueDateTime" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "effectiveFrom" + ] + }, + "valueDateTime": { + "type": "string", + "format": "date-time" + } + } + }, + { + "title": "Effective to date", + "type": "object", + "required": [ + "code", + "valueDateTime" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "effectiveTo" + ] + }, + "valueDateTime": { + "type": "string", + "format": "date-time" + } + } + }, + { + "title": "Specialty value", + "description": "This will only be returned when codeSystemType is CLINIC-TYPE", + "type": "object", + "required": [ + "code", + "valueCoding" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "specialty" + ] + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "Appointment cancellation reason type", + "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "valueCoding" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "appointmentBookingCancellationReasonType" + ] + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentBookingCancellationReasonType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentBookingCancellationReasonType-1" + }, + "code": { + "type": "string", + "example": "PROVIDER_REJECT" + } + } + } + } + }, + { + "title": "AppointmentCancellationUsage", + "description": "This will only be returned when `codeSystemType` is `APPOINTMENT-CANCELLATION-REASON`", + "type": "object", + "required": [ + "code", + "valueCoding" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "usage" + ], + "example": "usage" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentCancellationReasonUsage-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentCancellationReasonUsage-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECT", + "CANCEL" + ], + "example": "REJECT" + } + } + } + } + }, + { + "title": "Comment is mandatory value", + "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "valueBoolean" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "commentIsMandatory" + ] + }, + "valueBoolean": { + "type": "boolean" + } + } + }, + { + "title": "BusinessFunction", + "description": "This will only be returned when `codeSystemType` is `APPOINTMENT-CANCELLATION-REASON` or `REFERRAL-CANCELLATION-REASON`", + "type": "object", + "required": [ + "code", + "valueCoding" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "businessFunction" + ], + "example": "businessFunction" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + }, + { + "title": "Appointment request cancellation reason type", + "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "valueCoding" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "appointmentRequestCancellationReasonType" + ] + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentRequestCancellationReasonType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentRequestCancellationReasonType-1" + }, + "code": { + "type": "string", + "example": "PROVIDER" + } + } + } + } + }, + { + "title": "CanCancelAppointment", + "description": "This will only be returned when `codeSystemType` is REFERRAL-CANCELLATION-REASON", + "type": "object", + "required": [ + "code", + "valueBoolean" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "canCancelAppointment" + ], + "example": "canCancelAppointment" + }, + "valueBoolean": { + "type": "boolean" + } + } + }, + { + "title": "RequestCancellationReferrerUsage", + "description": "This will only be returned when `codeSystemType` is `REFERRAL-CANCELLATION-REASON`", + "type": "object", + "required": [ + "code", + "valueCoding" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "referrerUsage" + ], + "example": "referrerUsage" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralRequestCancellationReasonUsage-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralRequestCancellationReasonUsage-1" + }, + "code": { + "type": "string", + "enum": [ + "CANCEL_REFERRAL" + ], + "example": "CANCEL_REFERRAL" + } + } + } + } + }, + { + "title": "Defer to provider contact days", + "description": "This will only be returned when codeSystemType is PRIORITY", + "type": "object", + "required": [ + "code", + "valueInteger" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "deferToProviderContactDays" + ] + }, + "valueInteger": { + "type": "integer", + "example": 10 + } + } + }, + { + "title": "Triage contact days", + "description": "This will only be returned when codeSystemType is PRIORITY", + "type": "object", + "required": [ + "code", + "valueInteger" + ], + "properties": { + "code": { + "type": "string", + "enum": [ + "triageContactDays" + ] + }, + "valueInteger": { + "type": "integer", + "example": 10 + } + } + } + ] + } + } + } + } + } + } + }, + "examples": { + "specialty": { + "summary": "Specialty Reference Data", + "description": "This is example data only and should not be taken as the real reference data. Specialty data may have 'effectiveTo' dates in the past", + "value": { + "$ref": "../../../examples/getCodeSystem/responses/SpecialtyCodeSystem.json" + } + }, + "clinic-type": { + "summary": "Clinic Type Reference Data", + "description": "This is example data only and should not be taken as the real reference data.", + "value": { + "$ref": "../../../examples/getCodeSystem/responses/ClinicTypeCodeSystem.json" + } + }, + "appointment-cancellation-reason-code": { + "summary": "Appointment Cancellation Reason Reference Data", + "description": "This is example data only and should not be taken as the real reference data.", + "value": { + "$ref": "../../../examples/getCodeSystem/responses/AppointmentCancellationReasonCodeSystem.json" + } + }, + "referral-request-cancellation-reason-code": { + "summary": "ReferralRequest Cancellation Reason Reference Data", + "description": "This is example data only and should not be taken as the real reference data.", + "value": { + "$ref": "../../../examples/getCodeSystem/responses/ReferralCancellationReasonCodeSystem.json" + } + }, + "appointment-non-attendance-reason": { + "summary": "Appointment Non-attendance Reason Reference Data", + "description": "This is example data only and should not be taken as the real reference data.", + "value": { + "$ref": "../../../examples/getCodeSystem/responses/AppointmentNonAttendanceReasonCodeSystem.json" + } + }, + "priority": { + "summary": "Priority Reference Data", + "description": "This is example data only and should not be taken as the real reference data.", + "value": { + "$ref": "../../../examples/getCodeSystem/responses/PriorityCodeSystem.json" + } + } + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/$ers.fetchworklist": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to retrieve available worklists of referral requests. \nService Providers can use [[HYPERLINK_A023]] to retrieve available worklists of advice and guidance requests. \nThere are currently no worklists of advice and guidance requests for Referrers.\n\nWorklists provide lists of referral/advice requests that meet certain criteria, \ntypically where a user needs to be aware of something important, or to undertake an action, in order to avoid delays to patient care.\n\n## Referring Organisations\nReferring organisations can currently access the following referral related worklists:\n - The 'Letters Outstanding' worklist contains referrals which require a referral letter to be added.\n - The 'Rejected / Triage Response' worklist contains referrals which have had an appointment rejected or have been returned to the referrer with a response as part of a triage outcome.\n - The 'Assessment Returned / Cancelled / DNA' worklist contains referrals which have a clinical assessment outcome of 'advise referrer' recorded, or referrals which have been cancelled by someone outside the initial referring organisation, or referrals where the patient did not attend the appointment booking and the provider has returned the referral back to the referrer for action.\n - The 'Awaiting Booking' worklist contains referrals for which an appointment booking could be made but they do not currently have an appointment booking. This includes referrals that are currently awaiting triage, deferred to provider, or have had their appointment booking cancelled.\n\nFilters can be used in requests for service provider organisation worklists, however, filters cannot be used in requests for referring organisation worklists.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint and retrieve the referring organisation worklists, you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `REFERRING_ADMIN`\n\n### Use case\nAs an authenticated user\n\nI need to retrieve a referral worklist for my referring organisation\n\nSo that I can determine which referrals I need to take further action on\n\n### Related endpoints\nTo retrieve pertinent details relating to a referral:\n - Use [[HYPERLINK_A005]] to retrieve the details of the referral\n - Use [[HYPERLINK_A006]] to retrieve the clinical attachments for a referral\n - Use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for a referral\n\nYou can use [[HYPERLINK_A029]] to determine what endpoints an authenticated user is permitted to use for a referral in it's current state.\n\n## Service Providing Organisations\nService provider organisations can currently access the following referral related worklists:\n - 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.\n - 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). \n The referrals need to be reviewed and if appropriate booked into a service at the service provider organisation.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nSupported Worklists:\n- Referrals for Review\n- Appointment Slot Issues\n\nThe Service filter is mandatory when using this security pattern.\n\nThis endpoint must only be used to retrieve the worklist for a given service up to two times per day. If this does not meet your requirements, please [[HYPERLINK_CONTACT_US]] to discuss your use case.\n\nIf a worklist response exceeds 10MB, a successful response will not be returned. This is due to the size limitation on the APIM platform.\n\n### User-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nSupported Worklists:\n - Referrals for Review\n - Appointment Slot Issues\n\nIf a worklist response exceeds 10MB, a successful response will not be returned. This is due to the size limitation on the APIM platform.\n\n### Use case\nAs an authenticated user\n\nI need to retrieve a referral worklist for my service providing organisation\n\nSo that I can determine which referrals I need to take further action on\n\n### Related endpoints\n\nTo retrieve pertinent details relating to a referral:\n - Use [[HYPERLINK_A005]] to retrieve the details of the referral\n - Use [[HYPERLINK_A006]] to retrieve the clinical attachments for a referral\n - Use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for a referral\n\nFor service providing organisations reviewing booked referrals on the 'Referrals for review' worklist:\n - Use [[HYPERLINK_A013]] to accept a referral into a bookable service\n - Use [[HYPERLINK_A014]] to reject a referral from a bookable service\n - Use [[HYPERLINK_A022]] to request an admin team to rebook or redirect a referral\n\nFor service providing organisations reviewing triage (RAS) referrals on the 'Referrals for review' worklist:\n - Use [[HYPERLINK_A028]] to record the triage outcome based on the available clinical information and attachments\n\nFor service providing organisations reviewing referrals that have been deferred to provider on the 'Appointment slot issues' worklist:\n - Use [[HYPERLINK_A028]] to record the triage outcome based on the available clinical information and attachments\n", + "summary": "Retrieve referral worklist (A008, FHIR STU3)", + "operationId": "a008-retrieve-worklist", + "tags": [ + "Retrieve clinical information", + "Review referral requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-FetchWorklist-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `listType` | `1..1` | |\n| `service` | `0..1` | Mandatory for the application-restricted security pattern |\n| `specialtyAssignedIndicator` | `0..1` | |\n| `specialty` | `0..1` | | \n| `location` | `0..1` | | \n| `clinicianAssignedIndicator` | `0..1` | | \n| `clinician` | `0..1` | | \n", + "items": { + "anyOf": [ + { + "title": "listType", + "description": "Indicates the type of list requested", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "listType" + ], + "example": "listType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| -------------------------------- | ----------- | -------------------------------------- |\n| `eRS-ReferralListSelector` | `0..1` | |\n| `eRS-CommunicationListSelector` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-ReferralListSelector", + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRALS_FOR_REVIEW", + "APPOINTMENT_SLOT_ISSUES", + "REJECTED_TRIAGE_RESPONSE", + "ASSESSMENT_RETURNED_CANCELLED_DNA", + "AWAITING_BOOKING", + "LETTERS_OUTSTANDING" + ], + "example": "REFERRALS_FOR_REVIEW" + } + } + }, + { + "title": "eRS-CommunicationListSelector", + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVICE_AND_GUIDANCE_REQUESTS" + ], + "example": "ADVICE_AND_GUIDANCE_REQUESTS" + } + } + } + ] + } + } + } + } + } + }, + { + "title": "service", + "description": "The service identifier", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + }, + { + "title": "specialtyAssignedIndicator", + "description": "Indicates whether filtering on Specialty is required or not\n", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialtyAssignedIndicator" + ], + "example": "specialtyAssignedIndicator" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + }, + "code": { + "type": "string", + "enum": [ + "ASSIGNED", + "NOT_ASSIGNED" + ], + "example": "NOT_ASSIGNED" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "location", + "description": "The service location identifier", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "location" + ], + "example": "location" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "clinicianAssignedIndicator", + "description": "Indicates whether filtering on Clinician is required or not\n", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicianAssignedIndicator" + ], + "example": "clinicianAssignedIndicator" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + }, + "code": { + "type": "string", + "enum": [ + "ASSIGNED", + "NOT_ASSIGNED" + ], + "example": "NOT_ASSIGNED" + } + } + } + } + } + } + } + }, + { + "title": "clinician", + "description": "The clinician assigned to the Referral Request. If present, the 'clinicianAssignedIndicator' parameter must be set to 'Assigned'", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinician" + ], + "example": "clinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "referrals-for-review": { + "summary": "Referrals for review", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/MinimalReferralsForReview.json" + } + }, + "appointment-slot-issues": { + "summary": "Appointment slot issues", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/MinimalAppointmentSlotIssues.json" + } + }, + "filtered-by-specialty": { + "summary": "Filter by specialty", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/FilteringBySpecialty.json" + } + }, + "filtered-by-clinician": { + "summary": "Filter by clinician", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/FilteringByClinician.json" + } + }, + "filtered-by-service": { + "summary": "Filter by service", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/FilteringByService.json" + } + }, + "rejected-triage-responses": { + "summary": "Rejected Triage Responses", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/MinimalRejectedTriageResponse.json" + } + }, + "assessment-returned-cancelled-dna": { + "summary": "Assessment Returned Cancelled DNA", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/MinimalAssessmentReturnedCancelledDna.json" + } + }, + "awaiting-booking": { + "summary": "Awaiting Booking", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/MinimalAwaitingBooking.json" + } + }, + "letters-outstanding": { + "summary": "Letters Outstanding", + "value": { + "$ref": "../../examples/retrieveWorklist/requests/MinimalLettersOutstanding.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "The response body contains the list of referrals (if any) that match the search criteria provided", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-FetchWorklist-List", + "description": "A list of referrals representing the available worklist items", + "type": "object", + "required": [ + "meta", + "resourceType", + "status", + "mode" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------------------------------------------- |\n| `Practitioner` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n| `Patient` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n", + "items": { + "anyOf": [ + { + "title": "Practitioner", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "Practitioner-021600556514" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Practitioner" + ], + "example": "Practitioner" + }, + "identifier": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + }, + { + "title": "Patient", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "Patient-9912003888" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Patient" + ], + "example": "Patient" + }, + "identifier": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with referral details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070002" + } + } + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ----------------------------------------------------------- | ----------- | ------------------------------------------------------------- |\n| `Extension-eRS-ReferralsforReview-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AppointmentSlotIssues-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested | \n| `Extension-eRS-AdviceAndGuidanceRequests-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-RejectedTriageResponse-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AwaitingBooking-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-LettersOutstanding-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralsforReview-WorkListItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `requestContextStatus` | `1..1` | |\n| `clinicalInfoFirstSubmitted` | `0..1` | |\n| `clinicalInfoLastUpdated` | `0..1` | |\n| `appointmentStart` | `0..1` | |\n| `allocatedClinician` | `0..1` | |\n| `service` | `1..1` | |\n| `referralRequestVersion` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#Patient-9462979626" + } + } + } + } + }, + { + "title": "namedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#Practitioner-021600556514" + } + } + } + } + }, + { + "title": "eReferralPathwayStart", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "eReferralPathwayStart" + ], + "example": "eReferralPathwayStart" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "clinicalInfoPrinted", + "type": "object", + "required": [ + "url", + "valueBoolean" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoPrinted" + ], + "example": "clinicalInfoPrinted" + }, + "valueBoolean": { + "type": "boolean", + "example": false + } + } + }, + { + "title": "requestContextStatus", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "requestContextStatus" + ], + "example": "requestContextStatus" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "LETTER_CHANGED", + "PRIORITY_CHANGED", + "PRIORITY_AND_LETTER_CHANGED", + "NEVER_REVIEWED" + ], + "example": "NEVER_REVIEWED" + }, + "display": { + "type": "string", + "example": "Never Reviewed" + } + } + } + } + } + } + } + }, + { + "title": "clinicalInfoFirstSubmitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoFirstSubmitted" + ], + "example": "clinicalInfoFirstSubmitted" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "clinicalInfoLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoLastUpdated" + ], + "example": "clinicalInfoLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-03T10:44:42.764Z" + } + } + }, + { + "title": "referralType", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralType" + ], + "example": "referralType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" + }, + "code": { + "type": "string", + "enum": [ + "APPOINTMENT", + "TRIAGE_DEFERRAL" + ], + "example": "TRIAGE_DEFERRAL" + } + } + } + } + } + } + } + }, + { + "title": "appointmentStart", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "appointmentStart" + ], + "example": "appointmentStart" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-02T14:15:00.000Z" + } + } + }, + { + "title": "allocatedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "allocatedClinician" + ], + "example": "allocatedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#Practitioner-021600556514" + } + } + } + } + }, + { + "title": "service", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Service Name" + } + } + } + } + }, + { + "title": "referralRequestVersion", + "type": "object", + "required": [ + "url", + "valueInteger" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralRequestVersion" + ], + "example": "referralRequestVersion" + }, + "valueInteger": { + "type": "integer", + "example": 0 + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AppointmentSlotIssues-WorkListItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `ubrnReceived` | `0..1` | |\n| `patientContactExpected` | `0..1` | |\n| `clinicalInformationStatus` | `0..1` | |\n| `reason` | `0..1` | |\n| `lastContact` | `0..1` | |\n| `service` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "namedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "eReferralPathwayStart", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "eReferralPathwayStart" + ], + "example": "eReferralPathwayStart" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "clinicalInfoPrinted", + "type": "object", + "required": [ + "url", + "valueBoolean" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoPrinted" + ], + "example": "clinicalInfoPrinted" + }, + "valueBoolean": { + "type": "boolean", + "example": false + } + } + }, + { + "title": "ubrnReceived", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "ubrnReceived" + ], + "example": "ubrnReceived" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "patientContactExpected", + "type": "object", + "required": [ + "url", + "valueDate" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patientContactExpected" + ], + "example": "patientContactExpected" + }, + "valueDate": { + "type": "string", + "format": "date", + "example": "2021-09-07" + } + } + }, + { + "title": "clinicalInformationStatus", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInformationStatus" + ], + "example": "clinicalInformationStatus" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PRESENT", + "NOT_APPLICABLE", + "NOT_DUE", + "OVERDUE" + ], + "example": "NOT_DUE" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + } + } + } + } + } + }, + { + "title": "lastContact", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "lastContact" + ], + "example": "lastContact" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "service", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Service Name" + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AdviceAndGuidanceRequests-WorkListItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `category` | `1..1` | |\n| `adviceFirstRequested` | `1..1` | |\n| `adviceLastUpdated` | `1..1` | |\n| `referrer` | `1..1` | |\n| `service` | `1..1` | |\n| `clinicType` | `0..1` | |\n| `communicationRequestVersion` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "namedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "category", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "category" + ], + "example": "category" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_RESPONSE_REQUIRED", + "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", + "REFERRER_TO_REVIEW_RESPONSE", + "CONVERSATION_ENDED_CANCELLED", + "CONVERSATION_ENDED_CLOSED", + "ADVICE_CONVERTED" + ], + "example": "PROVIDER_RESPONSE_REQUIRED" + } + } + } + } + } + } + } + }, + { + "title": "adviceFirstRequested", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "adviceFirstRequested" + ], + "example": "adviceFirstRequested" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "adviceLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "adviceLastUpdated" + ], + "example": "adviceLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "adviceLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "adviceLastUpdated" + ], + "example": "adviceLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "service", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Service Name" + } + } + } + } + }, + { + "title": "clinicType", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/CLINIC-TYPE" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + } + } + } + }, + { + "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": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Rejected/TriageRequest worklist, only included if `status` is `TRIAGE_RESPONSE` |\n", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "referralLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLastUpdated" + ], + "example": "referralLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "status", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "status" + ], + "example": "status" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "ASSESSMENT_RESULT", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "NOT_BOOKED", + "BOOKED", + "AWAITING_TRIAGE", + "DEFERRED_TO_PROVIDER", + "APP_CANCELLED_BY_PROVIDER", + "APP_CANCELLED_BY_PATIENT", + "TRIAGED_PROVIDER_TO_ACTION", + "TRIAGE_RESPONSE" + ], + "example": "REJECTED" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Assessment result", + "Cancelled referral", + "Did not attend", + "Not booked", + "Booked", + "Awaiting triage", + "Deferred to provider", + "Appointment cancelled by provider", + "Appointment cancelled by patient", + "Triaged - provider to action", + "Triage Response" + ], + "example": "Rejected" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + ], + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "FURTHER_INFORMATION_REQUIRED" + }, + "display": { + "type": "string", + "example": "Further information required" + } + } + } + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" + }, + "extension": { + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Assessment Returned / Cancelled / DNA worklist, only included if `status` is `CANCELLED_REFERRAL` |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "referralLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLastUpdated" + ], + "example": "referralLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "status", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "status" + ], + "example": "status" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "ASSESSMENT_RESULT", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "NOT_BOOKED", + "BOOKED", + "AWAITING_TRIAGE", + "DEFERRED_TO_PROVIDER", + "APP_CANCELLED_BY_PROVIDER", + "APP_CANCELLED_BY_PATIENT", + "TRIAGED_PROVIDER_TO_ACTION", + "TRIAGE_RESPONSE" + ], + "example": "REJECTED" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Assessment result", + "Cancelled referral", + "Did not attend", + "Not booked", + "Booked", + "Awaiting triage", + "Deferred to provider", + "Appointment cancelled by provider", + "Appointment cancelled by patient", + "Triaged - provider to action", + "Triage Response" + ], + "example": "Rejected" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" + ], + "example": "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "INTEND_PRIVATE" + }, + "display": { + "type": "string", + "example": "Patient will go to a private clinic" + } + } + } + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AwaitingBooking-WorklistItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" + }, + "extension": { + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Awaiting Booking worklist, only included if `status` is `APPOINTMENT_CANCELLED_BY_PROVIDER` or `APPOINTMENT_CANCELLED_BY_PATIENT` |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "referralLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLastUpdated" + ], + "example": "referralLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "status", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "status" + ], + "example": "status" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "ASSESSMENT_RESULT", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "NOT_BOOKED", + "BOOKED", + "AWAITING_TRIAGE", + "DEFERRED_TO_PROVIDER", + "APP_CANCELLED_BY_PROVIDER", + "APP_CANCELLED_BY_PATIENT", + "TRIAGED_PROVIDER_TO_ACTION", + "TRIAGE_RESPONSE" + ], + "example": "REJECTED" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Assessment result", + "Cancelled referral", + "Did not attend", + "Not booked", + "Booked", + "Awaiting triage", + "Deferred to provider", + "Appointment cancelled by provider", + "Appointment cancelled by patient", + "Triaged - provider to action", + "Triage Response" + ], + "example": "Rejected" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + ], + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_APPOINTMENT_CLASH" + }, + "display": { + "type": "string", + "example": "Patient - Clashes with another appointment" + } + } + } + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-LettersOutstanding-WorklistItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" + }, + "extension": { + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `letterDue` | `1..1` | The `date` a referral letter is due for the `ReferralRequest` |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "letterDue", + "type": "object", + "required": [ + "url", + "valueDate" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "letterDue" + ], + "example": "letterDue" + }, + "valueDate": { + "type": "string", + "format": "date", + "example": "2021-11-24" + } + } + } + ] + } + } + } + } + ] + } + } + } + } + } + } + }, + "examples": { + "referrals-for-review": { + "summary": "Referrals for Review", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/ReferralsForReview.json" + } + }, + "appointment-slot-issues": { + "summary": "Appointment Slot Issues", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/AppointmentSlotIssues.json" + } + }, + "filtered-by-specialty": { + "summary": "Filtered by specialty", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/FilteredBySpecialty.json" + } + }, + "filtered-by-clinician": { + "summary": "Filtered by clinician", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/FilteredByClinician.json" + } + }, + "filtered-by-service": { + "summary": "Filtered by service", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/FilteredByService.json" + } + }, + "rejected-triage-responses": { + "summary": "Rejected Triage / Response", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/RejectedTriageResponse.json" + } + }, + "assessment-returned-cancelled-dna": { + "summary": "Assessment Returned / Cancelled / DNA", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/AssessmentReturnedCancelledDna.json" + } + }, + "awaiting-booking": { + "summary": "Awaiting Booking", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/AwaitingBooking.json" + } + }, + "letters-outstanding": { + "summary": "Letters Outstanding", + "value": { + "$ref": "../../../examples/retrieveWorklist/responses/LettersOutstanding.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request or service. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve details of a referral. This includes references to clinical attachments, related referrals and other important data.\n\nDuring the lifecycle of a referral, the state of the referral may change multiple times. To help with understanding the state of a referral, we provide an \"at a glance\" summary of the referral as detailed below:\n\n| Code returned via https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1 | Description |\n| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |\n| `APPT_CANCELLED_BY_PATIENT` | The referral's most recent appointment was cancelled at the request of, or directly by, a patient |\n| `APPT_CANCELLED_BY_PROVIDER` | The referral's most recent appointment was cancelled by the service provider |\n| `ASSESSMENT_RESULT` | A service provider has reviewed and drafted, or submitted a clinical assessment for the referral |\n| `AWAITING_TRIAGE` | The triage referral is currently pending review with a service provider |\n| `BOOKED` | This referral's appointment indicates a date and time with a service |\n| `CANCELLED_REFERRAL` | The referral has been cancelled and cannot be progressed any further |\n| `DEFERRED_TO_PROVIDER` | The service provider will arrange the patient's appointment |\n| `DID_NOT_ATTEND` | The patient did not attend their last appointment |\n| `NOT_BOOKED` | The referral is currently not booked, there is currently no planned patient encounter |\n| `REJECTED` | The referral was rejected by a provider at their service |\n| `TRIAGE_RESPONSE` | A service has passed the referral back to the referrer, with advice |\n| `TRIAGED_PROVIDER_TO_ACTION` | The service provider has recorded a review decision, with the intention of processing this referral |\n\nSome referral states may also have a `reason` and some reasons may also have a `comment`. These are described below:\n\n## Reason\n- The reason is always connected to the current state. This means the reason is likely to change each time the state changes. You cannot currently retrieve previous versions of a referral.\n- This reason may have been selected by a clinician or automatically applied by the e-RS system at the time the state was persisted.\n- A reason can be dynamic reference data, from any of the following sets of reference data: `APPOINTMENT-CANCELLATION-REASON`, `REFERRAL-CANCELLATION-REASON`, `APPOINTMENT-NON-ATTENDANCE-REASON`. These are retrievable from [[HYPERLINK_A004]].\n- A reason may be static reference data.\n\n## Comments\n- The comment is always connected to the current reason, and state. This means the comment is likely to change as the state changes.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user or application and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to retrieve details of a referral.\n\n## Important notes\n### Attachment availability\n\n In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A005]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|-------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE | The file is available for download. |\n| PENDING | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again |\n| THREATS FOUND | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n### Receiving an e-Referral Pathway Start Date\n \nThe e-Referral Pathway Start Date is a derived value of when the Referral To Treatment (RTT) clock starts. Find out how e-RS derives the pathway start date [[HYPERLINK_PATHWAY_START]].\n\nIf a referral was created with an alternate pathway start date, then this will be available in the referral request response.\n\nService providers must always ensure the correct start date is recorded in line with [[HYPERLINK_RTT_RULES]].\n\n## Use case\n\nAs an authenticated user or application\n\nI want to read details of a referral\n\nSo that I can decide what further action may be needed.\n\n## Related endpoints\n\nYou can retrieve attachments that are associated with the referral using [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]. Attachments can only be retrieved where the eRS-AvailabilityStatus-1 code returned is 'AVAILABLE'\n\nYou can retrieve a clinical information summary for the referral using [[HYPERLINK_A007]]\n\nYou can search for services appropriate to a referral to form a shortlist using [[HYPERLINK_A010]]\n\nIf bookable services are on the shortlist of the referral, you can retrieve appointment slots for a service on the shortlist for a referral using [[HYPERLINK_A015]]\n\nYou can retrieve the patient letter appropriate to the referral using [[HYPERLINK_A019]]\n\nYou can retrieve reference data used in viewing a referral using [[HYPERLINK_A004]]\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ----------------------- |\n| Unbooked `ReferralRequest` | `ubrn`=`000000070000` |\n| `ReferralRequest` booked to directly-bookable service | `ubrn`=`000000070001` |\n| `ReferralRequest` booked to indirectly-bookable service | `ubrn`=`000000070002` |\n| `ReferralRequest` deferred to service provider for booking | `ubrn`=`000000070003` |\n| `ReferralRequest` that was converted from an Advice and Guidance Request | `ubrn`=`000000070004` |\n| `ReferralRequest` with related `ReferralRequest` | `ubrn`=`000000070005` |\n| `ReferralRequest` with additional requirements listed | `ubrn`=`000000070011` |\n| `ReferralRequest` with attachments unavailable to download | `ubrn`=`000000070012` | \n", + "summary": "Retrieve referral request (A005, FHIR STU3)", + "operationId": "a005-retrieve-referral-request", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "unbooked": { + "summary": "Unbooked `ReferralRequest`", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/Unbooked.json" + } + }, + "booked-dbs": { + "summary": "`ReferralRequest` booked to directly-bookable service", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/BookedDBS.json" + } + }, + "booked-ibs": { + "summary": "`ReferralRequest` booked to indirectly-bookable service", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/BookedIBS.json" + } + }, + "deferred-to-provider": { + "summary": "`ReferralRequest` deferred to service provider for booking", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/DeferredToProvider.json" + } + }, + "converted-from-advice-and-guidance": { + "summary": "`ReferralRequest` that was converted from an Advice and Guidance Request", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/ConvertedFromAdviceAndGuidance.json" + } + }, + "with-related-referral": { + "summary": "`ReferralRequest` with related ReferralRequest", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/WithRelatedReferral.json" + } + }, + "with-additional-requirements": { + "summary": "`ReferralRequest` with additional requirements", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/WithAdditionalRequirements.json" + } + }, + "with-unavailable-attachments": { + "summary": "Unbooked `ReferralRequest` with attachments unavailable for download", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/WithUnavailableAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Task": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nThis endpoint allows an authenticated e-RS user to check ahead of performing an action, \nwhether or not the action is permitted. This endpoint performs a search for available and \nsupported actions that can be *currently* performed, by the *current* e-RS user on a *specific* \nreferral. When a permitted action is returned, the e-RS user could immediately attempt to \nperform a permitted action.\n\nYou SHOULD NOT cache the list of available user actions returned because this endpoint \ngives the *current* actions for the *current* e-RS user, for the referral in context and is therefore, \ntransient; a future call for a different e-RS user, referral, or at a different point in time, \nmight result in a different set of actions, leading to potential failure flows.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Application-restricted, unattended access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nSupported action:\n - Record Review Outcome\n - Cancel Referral\n\n### Healthcare worker, user-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou should obtain a `Unique Booking Reference Number` (UBRN) before using this endpoint, as the current UBRN version is required.\n\n## Use case\n\nAs an authenticated user\n\nI want to know what actions I might currently perform on a referral prior to attempting to do so\n\nSo that I can review my options, and do not try to persist a prohibited action\n\n## Important information about using this endpoint\n\nThis endpoint can be used to check permitted actions on a referral. Only a select number of results will be returned for which a corresponding action can be performed via the API. Not all actions are currently supported.\n\nAs a referrer, the actions returned can include:\n - Cancel Directly Booked Appointment \n - Cancel Referral\n - Create Appointment\n - Change Shortlist\n - Change Shortlist and Send for Triage\n\nAs a service provider, the actions returned can include:\n - Record Review Outcome\n - Cancel Referral\n\n## Related endpoints\n\nTo retrieve pertinent details relating to a referral:\n - Use [[HYPERLINK_A005]] to retrieve the details of the referral, UBRN and UBRN version.\n\nBelow is a list of actions that could be returned by calling [[HYPERLINK_A029]]\n - Use [[HYPERLINK_A028]] to record a review outcome based on the available clinical information and attachments.\n - Use [[HYPERLINK_A016]] to Book, or if unable, Defer, an appointment to a specific service on the current shortlist, or to make a triage deferral by sending an appointment to a triage service.\n - Use [[HYPERLINK_A031]] to change the shortlist of bookable services on an existing referral.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| --------------------------------------------------- | ---------------------------------------------------------------------------------------- |\n| No \"action\" is available | `focus`=`ReferralRequest/000000070000/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Record Review Outcome\" is available | `focus`=`ReferralRequest/000000070001/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Create Appointment\" is available | `focus`=`ReferralRequest/000000070002/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Change Shortlist\" is available | `focus`=`ReferralRequest/000000070003/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Change Shortlist and Send for Triage\" is available | `focus`=`ReferralRequest/000000070004/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Cancel Referral\" is available | `focus`=`ReferralRequest/000000070005/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Cancel Directly Booked Appointment\" is available | `focus`=`ReferralRequest/000000070006/_history/6`, `intent`=`proposal`, `status`=`ready` |\n", + "summary": "Available actions for user (A029, FHIR STU3)", + "operationId": "a029-available-actions-for-user-list", + "tags": [ + "Change appointment", + "Manage referral", + "Review referral requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "query", + "name": "focus", + "description": "The component describing the ReferralRequest for which the task list is requested for.\n\nPattern:\n\n`ReferralRequest/{ubrn}/_history/{version}`\n\n - The `ubrn` represents the unique booking reference number of the referral request\n - The `version` is the version of the referral request (only the most current version will be accepted)\n", + "required": true, + "schema": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/6" + } + }, + { + "in": "query", + "name": "intent", + "description": "Value must be set to `proposal`\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "proposal" + ], + "example": "proposal" + } + }, + { + "in": "query", + "name": "status", + "description": "The status of the `task`, value must be set to `ready`\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "ready" + ], + "example": "ready" + } + } + ], + "responses": { + "200": { + "description": "Bundle containing list of available tasks", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "Bundle resource containing tasks", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "type", + "link", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "604dc1ea-986c-45ec-b36c-cf9d2fabc5c0" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated", + "profile" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" + ], + "example": "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Bundle" + ], + "example": "Bundle" + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "link": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/STU3/Task?focus=ReferralRequest/000000070000/_history/6&intent=proposal&status=ready" + } + } + } + }, + "entry": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ----------------------- | ----------- | --------------------------------------------------- |\n| `CareConnect-Task` | `0..*` | |\n", + "items": { + "title": "CareConnect-Task", + "description": "CareConnect-Task details a single `task` (action available for user).\n", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/STU3/Task/ed4dff57-503c-46ef-9084-4045a23f4c2a" + }, + "resource": { + "title": "CareConnect-Task", + "description": "The Task resource represents a specific task to be performed by the user.", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "intent", + "focus" + ], + "properties": { + "id": { + "type": "string", + "example": "ed4dff57-503c-46ef-9084-4045a23f4c2a" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Task-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Task-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Task" + ], + "example": "Task" + }, + "status": { + "type": "string", + "enum": [ + "ready" + ], + "example": "ready" + }, + "intent": { + "type": "string", + "enum": [ + "proposal" + ], + "example": "proposal" + }, + "focus": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/6" + } + } + }, + "code": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "anyOf": [ + { + "title": "AvailableActionsForUser", + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailableActionsForUser-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailableActionsForUser-1" + }, + "code": { + "type": "string", + "enum": [ + "RECORD_REVIEW_OUTCOME", + "CREATE_APPOINTMENT", + "CHANGE_SHORTLIST", + "CHANGE_SHORTLIST_AND_SEND_FOR_TRIAGE", + "CANCEL_REFERRAL", + "CANCEL_DIRECTLY_BOOKED_APPOINTMENT" + ], + "example": "RECORD_REVIEW_OUTCOME" + }, + "display": { + "type": "string", + "enum": [ + "Record Review Outcome", + "Create Appointment", + "Change Shortlist", + "Change Shortlist and Send for Triage", + "Cancel Referral", + "Cancel Directly Booked Appointment" + ], + "example": "Record Review Outcome" + } + } + } + ] + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + } + } + } + } + } + }, + "examples": { + "empty": { + "summary": "Empty", + "value": { + "$ref": "../../../examples/availableActionsForUserList/Empty.json" + } + }, + "with-record-review-outcome": { + "summary": "With Record Review Outcome", + "value": { + "$ref": "../../../examples/availableActionsForUserList/WithRecordReviewOutcome.json" + } + }, + "with-create-appointment": { + "summary": "With Create Appointment", + "value": { + "$ref": "../../../examples/availableActionsForUserList/WithCreateAppointment.json" + } + }, + "with-change-shortlist": { + "summary": "With Change Shortlist", + "value": { + "$ref": "../../../examples/availableActionsForUserList/WithChangeShortlist.json" + } + }, + "with-change-shortlist-and-send-for-triage": { + "summary": "With Change Shortlist and Send for Triage", + "value": { + "$ref": "../../../examples/availableActionsForUserList/WithChangeShortlistAndSendForTriage.json" + } + }, + "with-cancel-referral": { + "summary": "With Cancel Referral", + "value": { + "$ref": "../../../examples/availableActionsForUserList/WithCancelReferral.json" + } + }, + "with-cancel-directly-booked-appointment": { + "summary": "With Cancel Directly Booked Appointment", + "value": { + "$ref": "../../../examples/availableActionsForUserList/WithCancelDBAppointment.json" + } + } + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| MISSING_PARAMETER | Indicates missing mandatory FHIR search parameter. |\n| HISTORY_NOT_SUPPORTED | Only the current version of the UBRN is permissible. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/_history/{version}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to retrieve a specific version of `ReferralRequest`.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nThe pre-requisites for this endpoint are the same as for endpoint [[HYPERLINK_A005]].\n\nNote: e-RS only supports the retrieval of the most recent version of `ReferralRequest`. You cannot retrieve earlier versions.\n\n## Important notes\n### Attachment availability\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A005]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|-------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE | The file is available for download. |\n| PENDING | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again |\n| THREATS FOUND | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n### Receiving an e-Referral Pathway Start Date \n \nThe e-Referral Pathway Start Date is a derived value of when the Referral To Treatment (RTT) clock starts. Find out how e-RS derives the pathway start date [[HYPERLINK_PATHWAY_START]].\n\nIf a referral was created with an alternate pathway start date, then this will be available in the referral request response.\n\nService providers must always ensure the correct start date is recorded in line with [[HYPERLINK_RTT_RULES]].\n\n## Use case\n\nSee [[HYPERLINK_A005]].\n\n## Related endpoints\n\nSee [[HYPERLINK_A005]].\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ------------------------------------- |\n| Unbooked `ReferralRequest` | `ubrn`=`000000070000`, `version`=`5` |\n| `ReferralRequest` booked to directly-bookable service | `ubrn`=`000000070001`, `version`=`5` |\n| `ReferralRequest` booked to indirectly-bookable service | `ubrn`=`000000070002`, `version`=`5` |\n| `ReferralRequest` deferred to service provider for booking | `ubrn`=`000000070003`, `version`=`5` |\n| `ReferralRequest` that was converted from an Advice and Guidance Request | `ubrn`=`000000070004`, `version`=`5` |\n| `ReferralRequest` with related `ReferralRequest` | `ubrn`=`000000070005`, `version`=`5` |\n| `ReferralRequest` with additional requirements listed | `ubrn`=`000000070011`, `version`=`5` |\n| `ReferralRequest` with attachments unavailable to download | `ubrn`=`000000070012`, `version`=`5` | \n", + "summary": "Retrieve referral request (versioned) (A005, FHIR STU3)", + "operationId": "a005-retrieve-referral-request-versioned", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "name": "version", + "in": "path", + "description": "The version of the resource to be retrieved. It must be the latest version of the resource otherwise\n`HISTORY_NOT_SUPPORTED` error will be returned (HTTP 404 Not Found).\n", + "required": true, + "schema": { + "type": "string", + "example": "5" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "unbooked": { + "summary": "Unbooked `ReferralRequest`", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/Unbooked.json" + } + }, + "booked-dbs": { + "summary": "`ReferralRequest` booked to directly-bookable service", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/BookedDBS.json" + } + }, + "booked-ibs": { + "summary": "`ReferralRequest` booked to indirectly-bookable service", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/BookedIBS.json" + } + }, + "deferred-to-provider": { + "summary": "`ReferralRequest` deferred to service provider for booking", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/DeferredToProvider.json" + } + }, + "converted-from-advice-and-guidance": { + "summary": "`ReferralRequest` that was converted from an Advice and Guidance Request", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/ConvertedFromAdviceAndGuidance.json" + } + }, + "with-related-referral": { + "summary": "`ReferralRequest` with related ReferralRequest", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/WithRelatedReferral.json" + } + }, + "with-additional-requirements": { + "summary": "`ReferralRequest` with additional requirements", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/WithAdditionalRequirements.json" + } + }, + "with-unavailable-attachments": { + "summary": "Unbooked `ReferralRequest` with attachments unavailable for download", + "value": { + "$ref": "../../../examples/retrieveReferralRequest/responses/WithUnavailableAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found - Resource not found for ID provided or Resource version does not match version requested." + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Binary/{attachmentLogicalID}": { + "get": { + "deprecated": true, + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n **This endpoint has now been deprecated please use [[HYPERLINK_A042]] instead.**\n\nUse this endpoint to retrieve a file that is attached to a referral or advice request.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n\n## Pre-requisites\n### Authentication\n#### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application.\n\n#### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user or application and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n### Attachment availability\nIn order to use this endpoint, the attachment to be retrieved must be available for download. Attachments are only made available once an uploaded file has been validated and successfully scanned for malware. A request to retrieve an attachment that is not available for download will result in a 422 error being returned. See the Response section for further information.\n\nThe availability status of an attachment can be retrieved via any endpoint that provides details of an attachment in the success response. Details of the availability statuses that may be returned via these endpoints can be found in the specification for [[HYPERLINK_A005]].\n\nPrior to retrieving an attachment, you will need to have retrieved the referral or advice request the attachment is associated with (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example). Referrals and advice requests include resolvable URLs to the files currently attached to them, which can be used with this endpoint to retrieve the attachments themselves.\n\n### Maximum file size\n\n The [[HYPERLINK_A006]] endpoint allows you to retrieve attachments up to a maximum file size of 5MB (5242880 bytes). Attempting to retrieve a file over this limit will lead to a 422 error being returned. See the Response section for further information. Due to this, prior to calling this endpoint, the size of the attachment being retrieved should first be validated so that this error can be avoided.\n\nFiles that are larger than 5MB can be downloaded via the [[HYPERLINK_A042]] endpoint or the e-RS web-based professional application.\n\n## Important notes\n\nA referral pathway in e-RS can be made up of more than one UBRN. \nFor example, a referral is booked and seen in a general knee clinical assessment service (UBRN #1), \nand the service decides to onward refer to a more specialist knee miniscus service (UBRN #2). \nThis would result in two UBRNs for the referral pathway in this example (but there could be more related UBRNs if onward referred multiple times).\n\nAs such, it is important that all clinical information is obtained from across all the related UBRNs referenced in [[HYPERLINK_A005]]. \nYou can do this using the following endpoints:\n\n - [[HYPERLINK_A007]]\n - [[HYPERLINK_A006]]\n\nNote: It is possible that the initial UBRN may be the only one in the referral pathway to have clinical information and/or attachments associated.\n\nThe [[HYPERLINK_A006]] endpoint allows you to retrieve attachments up to a maximum file size of 5MB (5242880 bytes), subject to the attachment being available for download. Attempts to retrieve an attachment that is not available, or exceeds the maximum file size, will lead to a 422 error being returned. See the Response section for further information.\n\n## Use case\n\nAs an authenticated user\n\nI need to retrieve a clinical attachment associated with a referral\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\n\nYou can retrieve a clinical information summary for a referral using [[HYPERLINK_A007]].\n\n## Sandbox test scenarios\n\nThe sandbox for this endpoint is a simple implementation that only supports success cases.\n\nA successful response will always be returned, provided the Binary ID is in a valid format. The Availability Status of a file is not considered in the sandbox and a file will always be available for retrieval.\n\nSuccessful responses will always return the same example PDF file.\n", + "summary": "Retrieve attachment (A006, FHIR STU3) [deprecated]", + "operationId": "a006-retrieve-attachment", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "path", + "name": "attachmentLogicalID", + "description": "Reference to attachment as provided in the output from [[HYPERLINK_A005]]\n", + "required": true, + "schema": { + "type": "string" + }, + "examples": { + "uuid-format": { + "value": "c5d2d200-7613-4a69-9c5f-1bb68e04b8d8", + "summary": "ID of an attachment utilising UUID ID format." + }, + "legacy-format": { + "value": "att-70000-70001", + "summary": "ID of an attachment utilising the legacy ID format." + } + } + } + ], + "responses": { + "200": { + "description": "Response contains the binary stream of the file attachment requested.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Disposition": { + "description": "The description of the type of content provided.\n", + "required": true, + "schema": { + "type": "string", + "example": "attachment; filename=\"000000070000_Appointment_Confirmation_Summary_20210603121353.pdf\"" + } + }, + "Content-Length": { + "description": "The length of the response.\n", + "required": true, + "schema": { + "type": "string", + "example": "3111" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "text/plain", + "text/html", + "application/pdf", + "text/xml", + "text/rtf", + "audio/basic", + "audio/mpeg", + "image/png", + "image/gif", + "image/jpeg", + "image/tiff", + "video/mpeg", + "application/msword", + "application/vnd.openxmlformats-officedocument.wordprocessingml.document", + "application/dicom" + ], + "example": "text/plain" + } + } + }, + "content": { + "text/plain": { + "schema": { + "type": "string", + "format": "binary" + }, + "example": "This is some example text." + }, + "text/html": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/xml": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/rtf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/basic": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/png": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/gif": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/jpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/tiff": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "video/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/msword": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/dicom": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| FILE_SIZE_ERROR | The file requested is larger than 5MB (5242880 bytes) so cannot be retrieved via this endpoint. Files larger than 5MB can be downloaded via the [[HYPERLINK_A042]] endpoint or the e-RS web-based professional application. |\n| PENDING | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. |\n| THREATS_FOUND | The file has been quarantined after detecting a threat and cannot be retrieved. Contact the organisation that uploaded the file to resolve the issue and get the information you need. Details of who uploaded the file can be retrieved via any endpoint that provides details of an attachment in the success response (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example) |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved. Contact the organisation that uploaded the file to resolve the issue and get the information you need. Details of who uploaded a file can be retrieved via any endpoint that provides details of an attachment in the success response (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example)
Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS. Note, this indicates that the file size is larger than the system supports as a whole, not the 5MB limit associated with this endpoint
\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/R4/Binary/{id}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve a file that is attached to a referral or advice request.\n\nReferral information can also include:\n - Structured clinical information added by an integrated primary care system\n - Service provider activity\n - Advice and guidance conversation\n\nThis additional clinical information must be retrieved via [[HYPERLINK_A007]]\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted, unattended access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user or application and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n### Attachment availability\nTo use this endpoint, the attachment must be available for download. Attachments are only available after successful validation and malware scans. A request to retrieve an attachment that is not available for download will result in a 400 error. See the Response HTTP 400 section for further information.\n\nThe availability status of an attachment can be retrieved via any endpoint that provides details of an attachment in the success response. Details of the availability statuses that may be returned via these endpoints can be found in the specification for [[HYPERLINK_A005]].\n\nPrior to retrieving an attachment, you will need to have retrieved the referral or advice request the attachment is associated with (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example). Referrals and advice requests include resolvable URLs to the files currently attached to them, which can be used with this endpoint to retrieve the attachments themselves.\n\n## Support for a temporary redirect\nThis endpoint makes use of a HTTP 307 temporary redirect. It redirects the caller to a temporary location from which the file contents can be downloaded directly.\n\nThe temporary location is only valid for a short period of time and should be used immediately. \n\nCallers of this endpoint must ensure they:\n - follow this redirect to retrieve the file\n - do not cache the temporary location\n - generate a new redirect each time the file is downloaded\n\nSee the Response HTTP 307 section for further information.\n\n## Important notes\nA referral pathway in e-RS can be made up of more than one UBRN. For example: a referral is booked and seen in a general knee clinical assessment service (UBRN #1), and the service decides to onward refer to a more specialist knee meniscus service (UBRN #2). This would result in two UBRNs for the referral pathway. There may be additional related UBRNs if there are multiple onward referrals.\n\nAs such, it is important that all clinical information is obtained from across all the related UBRNs referenced in [[HYPERLINK_A005]]. You can do this using the following endpoints:\n - [[HYPERLINK_A006]]\n - [[HYPERLINK_A007]]\n\nNote: It is possible that the initial UBRN may be the only one in the referral pathway to have clinical information and/or attachments associated.\n\n## Use case \nAs an authenticated user\n\nI need to retrieve a clinical attachment associated with a referral or advice request\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\n - [[HYPERLINK_A005]] to retrieve details of a referral. This includes references to clinical attachments, related referrals and other important data.\n - [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request. This endpoint provides important contextual information about the advice and guidance request (e.g. the service/specialty to which advice has been requested, etc).\n - [[HYPERLINK_A025]] to retrieve the advice and guidance conversation between the referring organisation and service providing organisation.\n - [[HYPERLINK_A007]] to generate a PDF file that summarises clinical information for a referral.\n\n## Sandbox test scenarios\nThe sandbox for this endpoint is a simple implementation that only supports success cases.\n\nInline with the behaviour described in \"Support for a temporary redirect\", the sandbox will return a HTTP 307 temporary redirect. For simplicity, the temporary location will be static and never expire, unlike the live environment.\n\nA successful response will always be returned, provided the Binary ID is in a valid format. The Availability Status of a file is not considered in the sandbox and a file will always be available for retrieval.\n\nSuccessful responses will always return the same example PDF file.\n", + "summary": "Retrieve attachment (A042, FHIR R4)", + "operationId": "a042-retrieve-attachment", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "path", + "name": "id", + "description": "The identifier for the binary.\n", + "required": true, + "schema": { + "type": "string" + }, + "examples": { + "uuid-format": { + "value": "c5d2d200-7613-4a69-9c5f-1bb68e04b8d8", + "summary": "A binary ID utilising the UUID ID format." + }, + "legacy-format": { + "value": "att-70000-70001", + "summary": "A binary ID utilising the legacy ID format." + } + } + } + ], + "responses": { + "307": { + "description": "Response redirects the user agent to a location (via the Location header) in the object store from which the attachment can be downloaded from.", + "headers": { + "x-correlation-id": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "x-request-id": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Location": { + "description": "The attachment location in the object store.", + "required": true, + "schema": { + "type": "string", + "format": "uri" + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| REC_BAD_REQUEST | invalid | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The request could not be processed due to an error. This could be due to either an error with the request or the state of the resource requested. See the diagnostics field for further information. |\n", + "headers": { + "x-correlation-id": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "x-request-id": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_BAD_REQUEST" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_RELATIONSHIP | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The caller has no legitimate relationship with the resource. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-found", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_FOUND" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.generateCRI": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to generate a PDF file that summarises clinical information for a referral.\n\nThis does not include files attached to a referral or advice request. These must be retrieved via [[HYPERLINK_A042]]\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\n## Important note\nA referral pathway in e-RS can be made up of more than one UBRN. For example, a referral is booked and seen in a general knee clinical assessment service (UBRN #1), \nand the service decides to onward refer to a more specialist knee miniscus service (UBRN #2). This would result in two UBRNs for the referral pathway \nin this example (but there could be more related UBRNs if onward referred multiple times).\n\nAs such, it is important that all clinical information is obtained from across all the related UBRNs referenced in [[HYPERLINK_A005]]. \nYou can do this using the following endpoints:\n - [[HYPERLINK_A007]]\n - [[HYPERLINK_A006]]\n\nNote: It is possible that the initial UBRN may be the only one in the referral pathway to have clinical information and/or attachments associated.\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve a clinical information summary (in PDF format) associated with the referral\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\nYou can retrieve clinical attachments that are associated with a referral using [[HYPERLINK_A006]].\n", + "summary": "Retrieve clinical information (A007, FHIR STU3)", + "operationId": "a007-retrieve-clinical-information", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "responses": { + "200": { + "description": "Response contains the binary stream of the clinical information summary (PDF).", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Disposition": { + "description": "The description of the type of content provided.\n", + "required": true, + "schema": { + "type": "string", + "example": "attachment; filename=\"000000070000_Appointment_Confirmation_Summary_20210603121353.pdf\"" + } + }, + "Content-Length": { + "description": "The length of the response.\n", + "required": true, + "schema": { + "type": "string", + "example": "3111" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/pdf" + ], + "example": "application/pdf" + } + } + }, + "content": { + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/HealthcareService/$ers.searchHealthcareServicesForPatient": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to find services that meet the referral needs of a patient.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a `patient`, for example via [[HYPERLINK_PDS]].\n\n## Use case\nAs an authenticated user\n\nI need to find services I can refer the patient to\n\nSo that I can offer the patient appropriate services that meet their referral needs\n\n## Important Notes\nIf using this endpoint for modifying an existing Referral (such as via the [[HYPERLINK_A031]] endpoint for example), you will need to provide the Commissioning Rule Organisation parameter. This ensures that the services returned in the response are valid for use with the Referral. You can obtain the 'Commissioning Rule Organisation' from [[HYPERLINK_A005]].\n\n## Related endpoints\nOnce you have identified appropriate services for the patient you can create a referral by choosing a shortlist of bookable and/or triage services using [[HYPERLINK_A011]]. You may then subsequently be able to use [[HYPERLINK_A016]] to book an appointment to a directly bookable service if an appointment slot is available, defer the booking responsibility to a directly bookable service if no appointment slot is available, or refer a patient into a triage service.\n", + "summary": "Patient service search (A010, FHIR STU3)", + "operationId": "a010-patient-service-search", + "tags": [ + "Refer patient", + "Request advice" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-PatientServiceSearch-Parameters", + "description": "The parameters used in patient services search", + "type": "object", + "required": [ + "meta", + "resourceType", + "parameter" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-PatientServiceSearch-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-PatientServiceSearch-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `RequestType` | `1..1` | |\n| `SortBy` | `1..1` | |\n| `Patient` | `1..1` | |\n| `SearchCriteria` | `1..1` | |\n| `ReferringClinician` | `0..1` | |\n| `CommissioningRuleOrganisation` | `0..1` | Required if searching for services for an existing Referral. This field should be provided using the returned Commissioning Rule Organisation already included on the Referral to ensure the services returned are valid. Note this field is not supported when searching with the `ADVICE_AND_GUIDANCE_REQUEST` request type. |\n", + "items": { + "anyOf": [ + { + "title": "RequestType", + "description": "The type of request in e-RS which this service search is aimed at creating or updating. \nThe options are appointment request (i.e. referral) or advice and guidance request. \nServices may support one or the other or both and will be filtered accordingly.\n", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "requestType" + ], + "example": "requestType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestType-1" + }, + "code": { + "type": "string", + "enum": [ + "APPOINTMENT_REQUEST", + "ADVICE_AND_GUIDANCE_REQUEST" + ], + "example": "APPOINTMENT_REQUEST" + } + } + } + } + }, + { + "title": "SortBy", + "description": "The service search returns the top results according to the sorting requested. \nTherefore, the sorting requested affects the selection of services that are included in the response.\n", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "sortBy" + ], + "example": "sortBy" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-SortBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-SortBy-1" + }, + "code": { + "type": "string", + "enum": [ + "DISTANCE", + "IWT" + ], + "example": "IWT" + }, + "display": { + "type": "string", + "example": "Indicative Appointment Wait Time" + } + } + } + } + }, + { + "title": "Patient", + "description": "Parameter to supply a patient", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + { + "title": "ReferringClinician", + "description": "Parameter to supply a referring clinician", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "referringClinician" + ], + "example": "referringClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "CommissioningRuleOrganisation", + "description": "Parameter to supply a commissioning rule organisation", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningRuleOrganisation" + ], + "example": "commissioningRuleOrganisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "SearchCriteria", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "searchCriteria" + ], + "example": "searchCriteria" + }, + "resource": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "rc-minimal": { + "summary": "Referring Clinician minimal search", + "value": { + "$ref": "../../examples/patientServiceSearch/requests/RcMinimal.json" + } + }, + "rc-search-by-clinical-term": { + "summary": "Referring Clinician search by clinical term", + "value": { + "$ref": "../../examples/patientServiceSearch/requests/RcSearchByClinicalTerm.json" + } + }, + "rc-search-by-named-clinician": { + "summary": "Referring Clinician search by named clinician", + "value": { + "$ref": "../../examples/patientServiceSearch/requests/RcSearchByNamedClinician.json" + } + }, + "rc-search-for-advice-service": { + "summary": "Referring Clinician search for services supporting Advice Requests", + "value": { + "$ref": "../../examples/patientServiceSearch/requests/RcSearchForAdviceService.json" + } + }, + "rca-with-iwt": { + "summary": "Referring Clinician Admin search", + "value": { + "$ref": "../../examples/patientServiceSearch/requests/RcaWithIWT.json" + } + }, + "rc-search-with-commissoning-rule-organisation": { + "summary": "Referring Clinician search with commissioning rule organisation", + "value": { + "$ref": "../../examples/patientServiceSearch/requests/RcSearchWithCommissioningRuleOrganisation.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "The response body contains the list of services (if any) that match the search criteria provided", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-FetchServices-List", + "description": "Service search response", + "type": "object", + "required": [ + "meta", + "resourceType", + "status", + "mode", + "entry" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchServices-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchServices-List-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "emptyReason": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/list-empty-reason" + ], + "example": "http://hl7.org/fhir/ValueSet/list-empty-reason" + }, + "code": { + "type": "string", + "enum": [ + "nilknown", + "notasked", + "withheld", + "unavailable", + "notstarted", + "closed" + ], + "example": "nilknown" + }, + "display": { + "type": "string", + "example": "no results" + } + } + } + } + } + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item", + "extension" + ], + "properties": { + "extension": { + "title": "Extension to supply search specific details for a service", + "type": "array", + "items": { + "title": "Extension-eRS-ServiceSearch-ListItem", + "type": "object", + "required": [ + "extension", + "url" + ], + "properties": { + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `DisplayProminently` | `1..1` | |\n| `Distance` | `0..1` | |\n| `IndicativeAppointmentWaitTime` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "DisplayProminently", + "description": "Extension to supply display prominently indicator", + "type": "object", + "required": [ + "url", + "valueBoolean" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "displayProminently" + ], + "example": "displayProminently" + }, + "valueBoolean": { + "type": "boolean", + "example": false + } + } + }, + { + "title": "Distance", + "description": "Extension to supply distance value", + "type": "object", + "required": [ + "url", + "valueUnsignedInt" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "distance" + ], + "example": "distance" + }, + "valueUnsignedInt": { + "type": "integer", + "format": "int32", + "example": 10 + } + } + }, + { + "title": "IndicativeAppointmentWaitTime", + "description": "Extension to supply indicative wait time, only one extension with url value 'indicativeAppointmentWaitTime' will be returned at once", + "type": "object", + "required": [ + "url", + "valueUnsignedInt" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTime" + ], + "example": "indicativeAppointmentWaitTime" + }, + "valueUnsignedInt": { + "type": "integer", + "format": "int32", + "example": 7 + } + } + }, + { + "title": "IndicativeAppointmentWaitTime", + "description": "Extension to supply indicative wait time, only one extension with url value 'indicativeAppointmentWaitTime' will be returned at once", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTime" + ], + "example": "indicativeAppointmentWaitTime" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-IWT-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-IWT-1" + }, + "code": { + "type": "string", + "enum": [ + "LIMITED_AVAILABILITY", + "NOT_APPLICABLE" + ], + "example": "LIMITED_AVAILABILITY" + } + } + } + } + } + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + }, + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSearch-ListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSearch-ListItem-1" + } + } + } + }, + "item": { + "type": "object", + "required": [ + "extension", + "identifier" + ], + "properties": { + "extension": { + "type": "array", + "items": { + "title": "Extension-eRS-ServiceSummaryView", + "description": "Extension to supply service summary view", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSummaryView-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSummaryView-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| -------------------------------- | ----------- | ------------------------------------------ |\n| `SupportedAppointmentType` | `0..1` | |\n| `ServiceName` | `1..1` | |\n| `SupportedRequestFlowType` | `1..2` | |\n| `IndicativeTreatmentWaitTime` | `0..1` | |\n| `BookableType` | `1..1` | |\n| `Location` | `1..1` | |\n| `ReferrerAlert` | `0..1` | |\n| `Exclusions` | `0..1` | |\n| `SuggestedInvestigations` | `0..1` | |\n| `ConditionsTreated` | `0..1` | |\n| `GenderTreated` | `1..1` | Sex treated. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `AdditionalRequirementSupported` | `0..3` | |\n| `ReferralLetterRequired` | `1..1` | |\n| `Specialty` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "SupportedAppointmentType", + "description": "Supported appointment type", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "supportedAppointmentType" + ], + "example": "supportedAppointmentType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "DAY_CASE", + "FIRST_OUTPATIENT", + "ASSESSMENT_SERVICE", + "GPSI", + "AHP_CLINIC", + "DIAGNOSTIC", + "NURSE_CLINIC", + "OPHTHALMOLOGIST", + "TELEPHONE_ASSESSMENT" + ], + "example": "DIAGNOSTIC" + } + } + } + } + } + } + } + }, + { + "title": "ServiceName", + "description": "Name of the service.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "serviceName" + ], + "example": "serviceName" + }, + "valueString": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + }, + { + "title": "SupportedRequestFlowType", + "description": "Services can support one or two Request Flow Types, but not Triage Request and Appointment Request simultaneously.", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "supportedRequestFlowType" + ], + "example": "supportedRequestFlowType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestFlowType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestFlowType-1" + }, + "code": { + "type": "string", + "enum": [ + "APPOINTMENT_REQUEST", + "TRIAGE_REQUEST", + "ADVICE_AND_GUIDANCE_REQUEST" + ], + "example": "APPOINTMENT_REQUEST" + } + } + } + } + } + } + } + }, + { + "title": "IndicativeTreatmentWaitTime", + "description": "Statistical indication of how long Patients have waited before receiving treatment.", + "type": "object", + "required": [ + "url", + "valueUnsignedInt" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "indicativeTreatmentWaitTime" + ], + "example": "indicativeTreatmentWaitTime" + }, + "valueUnsignedInt": { + "type": "integer", + "format": "int32", + "example": 15 + } + } + }, + { + "title": "IndicativeTreatmentWaitTime", + "description": "Statistical indication of how long Patients have waited before receiving treatment.", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "indicativeTreatmentWaitTime" + ], + "example": "indicativeTreatmentWaitTime" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CapacityAlert-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CapacityAlert-1" + }, + "code": { + "type": "string", + "enum": [ + "LOW" + ], + "example": "LOW" + } + } + } + } + } + } + } + }, + { + "title": "BookableType", + "description": "Whether the service is Directly or Indirectly Bookable", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "bookableType" + ], + "example": "bookableType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BookableType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BookableType-1" + }, + "code": { + "type": "string", + "enum": [ + "DIRECTLY_BOOKABLE", + "INDIRECTLY_BOOKABLE", + "UNSPECIFIED" + ], + "example": "DIRECTLY_BOOKABLE" + } + } + } + } + } + } + } + }, + { + "title": "LinkToNHSWebsite", + "description": "Link to NHS website providing information about the Service such as contact details, map, department, facilities and reviews.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "linkToNHSWebsite" + ], + "example": "linkToNHSWebsite" + }, + "valueString": { + "type": "string", + "example": "https://www.nhs.uk/service-search/other-services/chooseandbook?serviceId=11002" + } + } + }, + { + "title": "Location", + "description": "Service location", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "location" + ], + "example": "location" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + }, + "display": { + "type": "string", + "example": "Cicero-Clinic" + } + } + } + } + }, + { + "title": "ReferrerAlert", + "description": "Referrer Alert", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrerAlert" + ], + "example": "referrerAlert" + }, + "valueString": { + "type": "string", + "example": "Surgery and post op follow up will be done at Harrogate District Hospital" + } + } + }, + { + "title": "Exclusions", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "exclusions" + ], + "example": "Service Users under the age of 18" + }, + "valueString": { + "type": "string", + "example": "Exclusions" + } + } + }, + { + "title": "SuggestedInvestigations", + "description": "Suggested investigations", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "suggestedInvestigations" + ], + "example": "suggestedInvestigations" + }, + "valueString": { + "type": "string", + "example": "Relevant Xray" + } + } + }, + { + "title": "ConditionsTreated", + "description": "Conditions treated", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "conditionsTreated" + ], + "example": "conditionsTreated" + }, + "valueString": { + "type": "string", + "example": "Hip pain" + } + } + }, + { + "title": "AgeTreated", + "description": "Age range treated", + "type": "object", + "required": [ + "url", + "valueRange" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "ageTreated" + ], + "example": "ageTreated" + }, + "valueRange": { + "type": "object", + "required": [ + "low", + "high" + ], + "properties": { + "low": { + "type": "object", + "required": [ + "value", + "unit" + ], + "properties": { + "value": { + "type": "integer", + "example": 18 + }, + "unit": { + "type": "string", + "enum": [ + "YEARS", + "MONTHS" + ], + "example": "YEARS" + } + } + }, + "high": { + "type": "object", + "required": [ + "value", + "unit" + ], + "properties": { + "value": { + "type": "integer", + "example": 100 + }, + "unit": { + "type": "string", + "enum": [ + "YEARS", + "MONTHS" + ], + "example": "YEARS" + } + } + } + } + } + } + }, + { + "title": "GenderTreated", + "description": "Sex treated", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "genderTreated" + ], + "example": "genderTreated" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GenderTreated-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GenderTreated-1" + }, + "code": { + "type": "string", + "enum": [ + "MALE", + "FEMALE", + "MALE_AND_FEMALE" + ], + "example": "MALE_AND_FEMALE" + } + } + } + } + } + } + } + }, + { + "title": "AdditionalRequirementSupported", + "description": "Additional support services provided by the Organisation where the Service is located at", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "additionalRequirementSupported" + ], + "example": "additionalRequirementSupported" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "TRANSPORT", + "INTERPRETER", + "ADVOCACY" + ], + "example": "ADVOCACY" + } + } + } + } + } + } + } + }, + { + "title": "ReferralLetterRequired", + "description": "Indicates whether the Service requires a referral letter before they consider a referral to be valid", + "type": "object", + "required": [ + "url", + "valueBoolean" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLetterRequired" + ], + "example": "referralLetterRequired" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "Specialty", + "description": "The specialty supported by the Service", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + } + ] + } + } + } + } + }, + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + }, + "examples": { + "fetch-service-list-single-service": { + "summary": "With single service", + "value": { + "$ref": "../../../examples/patientServiceSearch/responses/FetchServiceListWithSingleService.json" + } + }, + "fetch-service-list-multiple-services": { + "summary": "With multiple services", + "value": { + "$ref": "../../../examples/patientServiceSearch/responses/FetchServiceListWithMultipleServices.json" + } + }, + "fetch-service-list-multiple-request-types": { + "summary": "With multiple supported request flow types", + "value": { + "$ref": "../../../examples/patientServiceSearch/responses/TriageAndAppointmentRequestType.json" + } + }, + "fetch-service-list-with-indicative-appointment-wait-time": { + "summary": "With indicative appointment wait time", + "value": { + "$ref": "../../../examples/patientServiceSearch/responses/WithIndicativeAppointmentWaitTime.json" + } + }, + "fetch-service-list-empty": { + "summary": "Empty result list", + "value": { + "$ref": "../../../examples/patientServiceSearch/responses/EmptyResponse.json" + } + }, + "fetch-advice-services": { + "summary": "With advice service", + "value": { + "$ref": "../../../examples/patientServiceSearch/responses/AdviceServiceSearch.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/$ers.createReferral": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to create a referral by choosing a shortlist of bookable services and/or triage services.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Important notes when creating a referral\nThe maximum amount of services allowed on a given shortlist is 20.\n\nThe act of shortlisting alone will not result in a referral being sent/booked to any of the shortlisted services (even if only one service is shortlisted).\nA shortlist of a single triage service should be avoided as this relies on the patient to progress the referral, potentially leading to a delay to care. Especially if the referral priority is 2WW or Urgent.\n\nUse [[HYPERLINK_A016]] if there is a need to support the sending/booking of the referral into a shortlisted service.\n\n## Important notes when sending an e-Referral Pathway Start Date\nThe e-Referral Pathway Start Date is a derived value of when the Referral To Treatment (RTT) clock starts. Find out how e-RS derives the pathway start date [[HYPERLINK_PATHWAY_START]].\n\nYou can supply an optional, alternate pathway start date when creating a referral.\n\nThis may be because steps, such as reviews, take place early in your business process. Which means the clock started earlier than when the e-RS referral is created. \nProviding an alternate pathway start date ensures the correct date is recorded and used in other systems.\n\nWhen provided, the pathway start date must be:\n - in the past\n - no longer than 365 days ago\n - calculated in line with [[HYPERLINK_RTT_RULES]]\n\nThis also overrides any e-RS derived date.\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a `patient`, for example via [[HYPERLINK_PDS]].\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Use case\nAs an authenticated user\n\nI need to create a shortlist of bookable services and/or triage services\n\nSo I can initiate my patients referral pathway, allowing the patient to book into one of the shortlisted services.\n\n## Related endpoints\n\nTo allow the patient to progress their referral in their own time, you can generate a letter for the patient by \nusing [[HYPERLINK_A019]]. The letter summarises the current state of the referral and any steps the \npatient may need to follow (e.g. appointment booking instructions).\n\nYou can book an appointment for the patient into a shortlisted directly bookable service using [[HYPERLINK_A015]] and [[HYPERLINK_A016]].\n\nYou can send the referral into a shortlisted triage service using [[HYPERLINK_A016]]. \n\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\nYou can generate a letter for the patient, which summarises the current state of their referral and any steps the patient may need to follow, by using [[HYPERLINK_A019]].\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Create referral (A011, FHIR STU3)", + "operationId": "a011-create-referral", + "tags": [ + "Refer patient" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CreateReferral-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferral-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferral-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `ReferringClinician` | `0..1` | |\n| `Shortlist` | `1..1` | |\n| `IntentionToAddReferralLetter` | `1..1` | | \n| `FirstReminderLetterFollowUpDays` | `1..1` | | \n| `EReferralPathwayStart` | `0..1` | | \n", + "items": { + "anyOf": [ + { + "title": "Patient", + "description": "Parameter to supply a patient", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + { + "title": "ReferringClinician", + "description": "Parameter to supply a referring clinician", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "referringClinician" + ], + "example": "referringClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "Shortlist", + "description": "Parameter to supply a shortlist", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "shortlist" + ], + "example": "shortlist" + }, + "resource": { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + } + } + }, + { + "title": "IntentionToAddReferralLetter", + "description": "Parameter to supply the intention to add referral letter flag", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "intentionToAddReferralLetter" + ], + "example": "intentionToAddReferralLetter" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + }, + "code": { + "type": "string", + "enum": [ + "NEED_TO_ADD_LATER", + "NOT_INTENDING_TO_ADD" + ], + "example": "NEED_TO_ADD_LATER" + } + } + } + } + }, + { + "title": "FirstReminderLetterFollowUpDays", + "description": "Parameter to supply the first reminder follow up days", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "firstReminderLetterFollowUpDays" + ], + "example": "firstReminderLetterFollowUpDays" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 0 + } + } + }, + { + "title": "EReferralPathwayStart", + "description": "Parameter to supply the pathway start date", + "type": "object", + "required": [ + "name", + "valueInstant" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "eReferralPathwayStart" + ], + "example": "eReferralPathwayStart" + }, + "valueInstant": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + } + } + }, + "examples": { + "rc-minimum-request-body": { + "summary": "Referring Clinician - minimum request body", + "value": { + "$ref": "../../examples/createReferral/requests/MinimalRequest.json" + } + }, + "rc-request-body-multi-service-shortlist": { + "summary": "Referring Clinician - request body using multi-service shortlist", + "value": { + "$ref": "../../examples/createReferral/requests/RequestTwentyServices.json" + } + }, + "rc-request-body-mixed-shortlist": { + "summary": "Referring Clinician - request body using mixed service shortlist", + "value": { + "$ref": "../../examples/createReferral/requests/RequestMixedShortlist.json" + } + }, + "create-referral-parameters-twenty-services": { + "summary": "Referring Clinician Admin - minimum request body", + "value": { + "$ref": "../../examples/createReferral/requests/MinimalRequestWithReferringClinician.json" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "A referral created within e-RS.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "referral-request-single-service": { + "summary": "Example with single service", + "value": { + "$ref": "../../../examples/createReferral/responses/ReferralRequest.json" + } + }, + "referral-request-twenty-services": { + "summary": "Example with twenty services", + "value": { + "$ref": "../../../examples/createReferral/responses/ReferralRequestTwentyServices.json" + } + }, + "referral-request-mixed-shortlist": { + "summary": "Example with a shortlist containing bookable and triage services", + "value": { + "$ref": "../../../examples/createReferral/responses/ReferralRequestMixedShortlist.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/$ers.createReferralAndSendForTriage": { + "post": { + "deprecated": true, + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n**This endpoint has now been deprecated please use [[HYPERLINK_A011]] instead.**\n\nUse this endpoint to refer the patient directly to a triage service.\n\nPlease note: this endpoint cannot be used to shortlist bookable services. In order to shortlist bookable services please use [[HYPERLINK_A011]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a `patient`, for example via [[HYPERLINK_PDS]].\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Use case\nAs an authenticated user\n\nI need to send the patient's referral to a triage service for assessment\n\nSo that I can put the patient on the appropriate clinical pathway for the chosen service provider.\n\n## Related endpoints\n\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\nYou can generate a letter for the patient by using [[HYPERLINK_A019]]. \nThe letter summarises the current state of the referral and any steps the patient may need to follow.\n\nYou can calculate the date when the patient will need to be contacted (by the triage service) using reference data from [[HYPERLINK_A004]].\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Create referral and send for triage (A021, FHIR STU3) [deprecated]", + "operationId": "a021-create-referral-request-and-send-for-triage", + "tags": [ + "Refer patient" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CreateReferralAndSendForTriage-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferralAndSendForTriage-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferralAndSendForTriage-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `ReferringClinician` | `0..1` | |\n| `Shortlist` | `1..1` | |\n| `IntentionToAddReferralLetter` | `1..1` | | \n| `FirstReminderLetterFollowUpDays` | `1..1` | | \n", + "items": { + "anyOf": [ + { + "title": "Patient", + "description": "Parameter to supply a patient", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + { + "title": "ReferringClinician", + "description": "Parameter to supply a referring clinician", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "referringClinician" + ], + "example": "referringClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "Shortlist", + "description": "Parameter to supply a shortlist. When sending for triage, \nthe shortlist must contain exactly one service, and this must support the 'triage request flow'.\n", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "shortlist" + ], + "example": "shortlist" + }, + "resource": { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + } + } + }, + { + "title": "IntentionToAddReferralLetter", + "description": "Parameter to supply the intention to add referral letter flag.\nWhen sending for triage, a referral letter is always required, therefore the only acceptable value is NEED_TO_ADD_LATER.\n", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "intentionToAddReferralLetter" + ], + "example": "intentionToAddReferralLetter" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + }, + "code": { + "type": "string", + "enum": [ + "NEED_TO_ADD_LATER" + ], + "example": "NEED_TO_ADD_LATER" + } + } + } + } + }, + { + "title": "FirstReminderLetterFollowUpDays", + "description": "Parameter to supply the first reminder follow up days. When sending for triage, \nthe only acceptable value is 0, which means no follow up letter will be sent, \nas the patient does not need to book an appointment.\n", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "firstReminderLetterFollowUpDays" + ], + "example": "firstReminderLetterFollowUpDays" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 0 + } + } + } + ] + } + } + } + }, + "examples": { + "parameters": { + "summary": "Referring Clinician creates referral to a Triage service", + "value": { + "$ref": "../../examples/createReferralAndSendForTriage/requests/Parameters.json" + } + }, + "parameters-with-named-clinician": { + "summary": "Referring Clinician Admin minimum call", + "value": { + "$ref": "../../examples/createReferralAndSendForTriage/requests/ParametersWithNamedClinician.json" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "A referral created within e-RS.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "referral-request-with-appointment": { + "summary": "Basic example", + "value": { + "$ref": "../../../examples/createReferralAndSendForTriage/responses/ReferralRequest.json" + } + }, + "referral-request-with-named-clinician": { + "summary": "Example with named clinician in search criteria", + "value": { + "$ref": "../../../examples/createReferralAndSendForTriage/responses/ReferralRequestWithNamedClinician.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Slot": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve available appointment slots for a service.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a directly bookable `service` that is on the current referral shortlist. You can do this by using [[HYPERLINK_A005]].\n\n## Use case\n\nAs an authenticated user\n\nI need to retrieve a list of available appointment slots for a service\n\nSo that I can offer them to the patient for booking.\n\n## Important note\nYou need to provide the 'commissioning rule organisation' when calling [[HYPERLINK_A015]] to ensure only suitable slots are returned. You can obtain the 'commissioning rule organisation' from [[HYPERLINK_A005]].\n\nWhen slots are retrieved using this endpoint, they can include slots with or without a named clinician associated with them. Your integrated application must support both scenarios.\n\nSlots with a named clinician will have an additional \"actor\" which defines the SDS User ID of the clinician, this will be on the Schedule associated to the Slot.\n\n## Related endpoints\n\nYou can book an appointment to an available slot using [[HYPERLINK_A016]].\n\nYou can defer booking to a directly bookable service using [[HYPERLINK_A016]] but only in the following circumstances:\n - when the service has no available slots\n - when trying to book an appointment into a service, the slot advertised is no longer available\n - when trying to book an appointment into a service, no response is received within message timeout period (currently 2 minutes)\n\n## Known Issues\nThis endpoint is using the :Practitioner search parameter. The \"schedule.actor\" search parameter is incorrectly using the \":Practitioner\" modifier. As per the [FHIR standard](https://hl7.org/fhir/R4/) the \":identifier\" modifier should be used when searching to indicate that an Identifer is used rather than a literal, relative, internal or absolute reference. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment:\n\n| Scenario | Request Query Parameters | Response |\n| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |\n| Minimum slot search | `schedule.actor:HealthcareService`=`12000`, `appointmentType`=`ROUTINE`, `_count`=`20`, `status`=`free`, `page`=`1` | Illustrates minimum usage/parameters with concise, minimal response. |\n| Empty slot search response | `schedule.actor:HealthcareService`=`10000`, `appointmentType`=`ROUTINE`, `_count`=`20`, `status`=`free`, `page`=`1` | Illustrates how a 'no slots' response appears. |\n| Multipage slot search (page 1) | `schedule.actor:HealthcareService`=`11000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`1` | Illustrates first page of multi-page response. |\n| Multipage slot search (page 2) | `schedule.actor:HealthcareService`=`11000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`2` | Illustrates second page of multi-page response. |\n| Multipage slot search (invalid page 5) | `schedule.actor:HealthcareService`=`11000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`5` | Illustrates error when page is outside of valid range. |\n| Multi schedule response | `schedule.actor:HealthcareService`=`13000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`1` | Illustrates response when there is >1 Schedule: one Schedule is for slots with no associated clinician and the other does have an associated clinician. |\n| Slot clinician search | `schedule.actor:HealthcareService`=`14000`, `schedule.actor:Practitioner`=`921600556514`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`1` | Illustrates search for clinician-specific slots |\n", + "summary": "Retrieve appointment slots (A015, FHIR STU3)", + "operationId": "a015-retrieve-appointment-slots", + "tags": [ + "Arrange appointment" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Comm-Rule-Org", + "description": "To retrieve accurate slot information for a specific ReferralRequest the code from the ReferralRequest's 'Extension-eRS-Commissioning-Rule-Org-1' field should be passed to the slot search in this field otherwise slots which are, in fact, unbookable for that ReferralRequest may be returned\n", + "required": true, + "schema": { + "type": "string", + "example": "R68" + } + }, + { + "in": "query", + "name": "schedule.actor:HealthcareService", + "description": "A single service ID is required to indicate the service for which appointment slots are required.\n", + "required": true, + "schema": { + "type": "string", + "example": "11000" + } + }, + { + "in": "query", + "name": "appointmentType", + "description": "The priority of the appointment slots.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "ROUTINE" + } + }, + { + "in": "query", + "name": "status", + "description": "The status of the appointment slots required must be supplied. This must indicate that 'free' slots are required.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "free" + ], + "example": "free" + } + }, + { + "in": "query", + "name": "_count", + "description": "The pageSize is the maximum number of results (i.e. slots) that should be returned by this call. This value must be in the range of 1-100. 100 is the maximum slots available per API call.\n**Note:** Page contents cannot be guaranteed to be contiguous with no gaps or duplicates since the availability of slots may change between calls to the API.\n", + "required": true, + "schema": { + "type": "integer", + "minimum": 1, + "maximum": 100, + "format": "int32", + "example": 5 + } + }, + { + "in": "query", + "name": "page", + "description": "The number of the page required to be returned, starting at 1.\n", + "required": true, + "schema": { + "type": "integer", + "minimum": 1, + "format": "int32", + "example": 1 + } + }, + { + "in": "query", + "name": "schedule.actor:Practitioner", + "description": "Slots in e-RS may be allocated to a clinician and is set in the service provider's PAS. \nIf a named clinician is supplied (by the UUID), the appointment slots returned are constrained to slots for which this clinician is allocated to the appointment slot. \nThe clinician must be a named clinician for the selected service.\n", + "required": false, + "schema": { + "type": "string", + "example": "921600556514" + } + }, + { + "in": "query", + "name": "_include", + "description": "An optional URL parameter to cause service/clinician information to be returned ('_include=Slot:schedule') is recognised (i.e. causes no error and is understood by e-RS) but e-RS will return a Schedule for each Slot whether this parameter is present or not.\n", + "required": false, + "schema": { + "type": "string", + "example": "Slot:schedule" + } + } + ], + "responses": { + "200": { + "description": "The Response contains a FHIR 'Bundle' that, in turn, contains 'Slot' resources where each 'Slot' resource includes the 'Reference' to the slot and the slot's 'start' and 'end' times.\n\nThe Response Bundle also contains one or more 'Schedule' resources each of which is used to indicate which allocated clinician a Slot is associated with (if any). \nThe 'Schedule' also indicates the Service Id that will be the same Service for which the Slot search was performed.\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "Bundle resource containing appointment slots", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "type", + "total", + "link", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "08acc887-6a7b-4b38-8f50-022e41319efe" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated", + "profile" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" + ], + "example": "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Bundle" + ], + "example": "Bundle" + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "total": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 3 + }, + "link": { + "type": "array", + "minItems": 1, + "maxItems": 3, + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self", + "previous", + "next" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/STU3/Slot?schedule.actor%3AHealthcareService=11010&appointmentType=ROUTINE&_count=10&status=free&_include=Slot%3Aschedule&page=1" + } + } + } + }, + "entry": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Slot` | `1..*` | |\n| `Schedule` | `1..*` | |\n", + "items": { + "anyOf": [ + { + "title": "Slot", + "description": "Slot resource includes the 'Reference' to the slot and the slot's 'start' and 'end' times.\n", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/STU3/Slot/11000010" + }, + "resource": { + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier", + "schedule", + "status", + "start", + "end" + ], + "properties": { + "id": { + "type": "string", + "example": "11000009" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Slot-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Slot-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Slot" + ], + "example": "Slot" + }, + "identifier": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/alternative-slot" + ], + "example": "https://fhir.nhs.uk/Id/alternative-slot" + }, + "value": { + "type": "string", + "example": "USRN-11000009" + } + } + } + }, + "schedule": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Schedule/11000-921600556514" + } + } + }, + "status": { + "type": "string", + "enum": [ + "free" + ], + "example": "free" + }, + "start": { + "type": "string", + "format": "date-time", + "example": "2021-05-19T18:00:00.000Z" + }, + "end": { + "type": "string", + "format": "date-time", + "example": "2021-05-19T19:00:00.000Z" + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + } + } + }, + { + "title": "Schedule", + "description": "Schedule resource is used to indicate which allocated clinician a Slot is associated with (if any). \nThe 'Schedule' also indicates the Service Id that will be the same Service for which the Slot search was performed\n", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/STU3/Schedule/11000-921600556514" + }, + "resource": { + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier", + "actor" + ], + "properties": { + "id": { + "type": "string", + "example": "11000-921600556514" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Schedule-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Schedule-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Schedule" + ], + "example": "Schedule" + }, + "identifier": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ers-schedule" + ], + "example": "https://fhir.nhs.uk/Id/ers-schedule" + }, + "value": { + "type": "string", + "example": "11000-921600556514" + } + } + } + }, + "actor": { + "type": "array", + "minItems": 1, + "maxItems": 2, + "items": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "anyOf": [ + { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + ] + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "include" + ], + "example": "include" + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "minimum": { + "summary": "Minimum slot search", + "value": { + "$ref": "../../../examples/retrieveAppointmentSlots/responses/Minimum.json" + } + }, + "empty": { + "summary": "Empty slot search response", + "value": { + "$ref": "../../../examples/retrieveAppointmentSlots/responses/NoSlots.json" + } + }, + "page1of2": { + "summary": "Multipage slot search (page 1)", + "value": { + "$ref": "../../../examples/retrieveAppointmentSlots/responses/Page1PageSize5.json" + } + }, + "page2of2": { + "summary": "Multipage slot search (page 2)", + "value": { + "$ref": "../../../examples/retrieveAppointmentSlots/responses/Page2PageSize5.json" + } + }, + "multi-schedule": { + "summary": "Multi schedule response", + "value": { + "$ref": "../../../examples/retrieveAppointmentSlots/responses/Page1With2Schedules.json" + } + }, + "slot-clinician-search": { + "summary": "Slot clinician search", + "value": { + "$ref": "../../../examples/retrieveAppointmentSlots/responses/SlotClinicianSearch.json" + } + } + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| MISSING_PARAMETER | Indicates missing mandatory FHIR search parameter. |\n| MISSING_HEADER | Indicates missing mandatory HTTP header. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| SERVICE_UNAVAILABLE | Indicates that a service is no longer available. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "INVALID_VALUE", + "display": "Invalid value" + } + ] + }, + "diagnostics": "'Page Number' (5) is invalid." + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Appointment": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to book an appointment to a directly bookable service if an appointment slot is available, defer the booking responsibility to a directly bookable service if no appointment slot is available, or refer a patient into a triage service. \n\nIt is not possible to book into an indirectly bookable service using this endpoint. The patient will need to contact the service provider on the telephone number provided on [[HYPERLINK_A019]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to check if the service is directly bookable, indirectly bookable, or triage by either using [[HYPERLINK_A033]] or [[HYPERLINK_A035]]. You can then offer appropriate actions to authenticated users, i.e. the ability to book an appointment into a directly bookable service if an appointment slot is available, defer the booking responsibility to a directly bookable service if no appointment slot is available, refer a patient into a triage service.\n\nIf the service is directly bookable, you need to retrieve available appointment slots for the service using [[HYPERLINK_A015]].\n\nYou need to use the Unique Booking Reference Number (UBRN) of a referral request in order to use this endpoint. \n\n## Important note when deferring to provider\n\nYou should only defer booking to a directly bookable service in the following circumstances:\n - when the service has no available slots *or*\n - when trying to book an appointment into a service, the slot advertised is no longer available *or*\n - when trying to book an appointment into a service, no response is received within the message timeout period (currently 2 minutes)\n\n## Important note when booking slots\n\nWhen appointment slots are booked using this endpoint, it may be necessary to provide the named clinician details. This is because slots can be setup with or without a named clinician. Your integrated application must support both scenarios.\n\nWhen booking a slot using [[HYPERLINK_A016]], the named clinician details must be added to the \"Appointment.partcipant\" list. As shown in the \"Booking with named clinician\" example.\n\n## Use case\nAs an authenticated user\n\nI need to be able to\n - Book an appointment into an available appointment slot for a directly bookable service *or*\n - Defer the booking responsibility to a directly bookable service if no appointment slot is available *or*\n - Refer the patient into a triage service\n\nSo I can progress my patient's care at that service.\n\n## Related endpoints\nYou can generate a letter for the patient, summarising the current state of their referral and any steps \nthe patient may need to follow using [[HYPERLINK_A019]].\n\nWhere deferring the booking responsibility to a directly bookable service, or referring the patient into a triage service, you can calculate the date when the patient can expect to be contacted (by the receiving service) using reference data from [[HYPERLINK_A004]].\n\n ## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Book or defer appointment (A016, FHIR STU3)", + "operationId": "a016-book-or-defer-appointment", + "tags": [ + "Arrange appointment", + "Arrange triage" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + "examples": { + "minimal-booking": { + "summary": "Minimum booking", + "value": { + "$ref": "../../examples/bookOrDeferAppointment/requests/MinimalBooking.json" + } + }, + "minimal-deferral": { + "summary": "Minimum deferral", + "value": { + "$ref": "../../examples/bookOrDeferAppointment/requests/MinimalDeferral.json" + } + }, + "triage-deferral": { + "summary": "Triage deferral", + "value": { + "$ref": "../../examples/bookOrDeferAppointment/requests/TriageDeferral.json" + } + }, + "booking-with-named-clinician": { + "summary": "Booking with named clinician", + "value": { + "$ref": "../../examples/bookOrDeferAppointment/requests/BookingWithNamedClinician.json" + } + }, + "deferral-with-slot-reference": { + "summary": "Deferral with slot reference", + "value": { + "$ref": "../../examples/bookOrDeferAppointment/requests/DeferralWithSlotReference.json" + } + }, + "deferral-booking-attempt-problem": { + "summary": "Deferral booking attempt problem", + "value": { + "$ref": "../../examples/bookOrDeferAppointment/requests/DeferralBookingAttemptProblem.json" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "An appointment within e-RS.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + "examples": { + "minimal-booking": { + "summary": "Minimum booking", + "value": { + "$ref": "../../../examples/bookOrDeferAppointment/responses/MinimalBooking.json" + } + }, + "minimal-deferral": { + "summary": "Minimum deferral", + "value": { + "$ref": "../../../examples/bookOrDeferAppointment/responses/MinimalDeferral.json" + } + }, + "triage-deferral": { + "summary": "Triage deferral", + "value": { + "$ref": "../../../examples/bookOrDeferAppointment/responses/TriageDeferral.json" + } + }, + "booking-with-named-clinician": { + "summary": "Booking with named clinician", + "value": { + "$ref": "../../../examples/bookOrDeferAppointment/responses/BookingWithNamedClinician.json" + } + }, + "deferral-with-slot-reference": { + "summary": "Deferral with slot reference", + "value": { + "$ref": "../../../examples/bookOrDeferAppointment/responses/DeferralWithSlotReference.json" + } + }, + "deferral-booking-attempt-problem": { + "summary": "Deferral booking attempt problem", + "value": { + "$ref": "../../../examples/bookOrDeferAppointment/responses/DeferralBookingAttemptProblem.json" + } + } + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| SERVICE_UNAVAILABLE | Indicates that a service is no longer available. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| INAPPROPRIATE_SLOT | The slot provided is not suitable. |\n| SLOT_NOT_AVAILABLE | Slot is no longer available. |\n| UNABLE_TO_CONFIRM_APPOINTMENT | An unexpected error prevented eRS from successfully confirming the appointment. |\n| SLOTS_CURRENTLY_AVAILABLE | There are currently future slots available, so you cannot defer to this Service to book. |\n| THIS_SLOT_IS_AVAILABLE | Slot is currently available. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "502": { + "description": "Where status code 502 (Bad Gateway) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_RESPONDED_WITH_ERROR | Error received from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_RESPONDED_WITH_ERROR", + "display": "Error received from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: ERROR" + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + }, + "504": { + "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "timeout", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_NOT_RESPONDING", + "display": "No response from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" + } + ] + } + } + } + } + } + } + }, + "/STU3/Binary": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to upload a file containing clinical information to e-RS ready to be associated with a referral, an advice and guidance request or an advice and guidance response.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou can only upload file formats that are supported by e-RS. Currently, the supported file formats are:\n\n| File type | File extension(s) |\n| ------------------ | --------------------------- |\n| Plain Text | `.txt` |\n| PDF | `.pdf` |\n| XML Text | `.xml` |\n| RTF Text | `.rtf`, `.rtx` |\n| Basic Audio | `.au` |\n| MPEG audio layer 3 | `.mp3` |\n| PNG Image | `.png` | \n| GIF Image | `.gif` |\n| JPEG Image | `.jpg,` `.jpe`, `.jpeg` |\n| TIFF Image | `.tif`, `.tiff` |\n| MPEG Video | `.mpg`, `.mpeg`, `.mpe` |\n| MSWORD | `.doc`, `.docx` |\n| DICOM | `.dcm` |\n\nCurrently, the maximum file size supported by e-RS is 5MB.\n\n## Use case\n\nAs an authenticated user\n\nI need to upload a referral letter or other clinical information file to e-RS\n\nSo that I can associate the file with an existing referral or advice and guidance request.\n\n## Important notes\n\nThis endpoint **only** performs the file upload and **does not** associate it with a referral. The uploaded file must be explicitly associated with a referral by, for example, using [[HYPERLINK_A012]].\n\nThe resulting URL within e-RS for the uploaded file is returned in the 'Location' header of the response.\n\nRequest header `NHSD-eRS-Referral-ID` - the ID (typically the UBRN) of the referral which the documents are intended for - is non-mandatory, but must be provided if this file is to be attached to an existing request.\n\n## Related endpoints\n\nYou can associate the uploaded file with a specific referral using:\n - [[HYPERLINK_A012]]\n - [[HYPERLINK_A022]]\n - [[HYPERLINK_A028]]\n\nYou can associate the uploaded file with a specific advice and guidance request using:\n - [[HYPERLINK_A044]]\n - [[HYPERLINK_A026]]\n - [[HYPERLINK_A027]]\n", + "summary": "Upload file to document store (A020, FHIR STU3)", + "operationId": "a020-upload-file-to-document-store", + "tags": [ + "Refer patient", + "Request advice", + "Arrange appointment", + "Arrange triage" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "NHSD-eRS-File-Name", + "description": "The name of file being uploaded, including the extension\n", + "required": true, + "schema": { + "type": "string", + "example": "test.txt" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Referral-ID", + "description": "The ID (typically the UBRN) of the referral which the documents are intended for. This must be provided if this file is to be attached to an existing request.\n", + "required": false, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "requestBody": { + "required": true, + "content": { + "text/plain": { + "schema": { + "type": "string", + "format": "binary" + }, + "example": "This is some example text." + }, + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/xml": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/rtf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/basic": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/png": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/gif": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/jpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/tiff": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "video/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/msword": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/dicom": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "responses": { + "201": { + "description": "201 (Created) - success response with no body", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Location": { + "description": "The e-RS file location of the file which has been uploaded.\n", + "required": true, + "schema": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n| FILE_SIZE_ERROR | The file is either empty or too large. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.maintainReferralLetter": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to manage the set of 'referral letter' attachments associated with an existing referral, including adding or removing attachments from a referral.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nAll new files to be associated with a referral must be uploaded first using [[HYPERLINK_A020]] and then linked to the referral using this endpoint.\n\n## Important notes\n\nThis endpoint can be used to associate attachments to a referral that has no existing referral letter attachments. \nIn this case you must upload the file first using [[HYPERLINK_A020]] and then associate it to the referral using this endpoint.\n\nYou can also use this endpoint to modify the *set* of referral letter attachments already associated with a referral. \nIn this case, you must post all referral letter attachments you wish to be (finally) associated to the referral, \nincluding any that were already associated. In other words, this endpoint replaces the set of referral letter \nattachments previously associated - with those specified in your latest request. \nAs such, it is imperative that this call references all the attachments the user wishes to keep, every time it is called.\n\nBelow are three example scenarios which clarify the behaviour of the endpoint when referral attachments are already present on the referral:\n\n1. Let us consider a referral that has two referral letter attachments associated (say \"A.pdf\" and \"B.pdf\"). If \nyou wish to add an additional attachment (say \"C.pdf\"), you must upload the additional attachment \n\"C.pdf\" using [[HYPERLINK_A020]], and then associate attachments \"A.pdf\", \"B.pdf\" and \"C.pdf\" \nvia this endpoint in a single request. That is, all three attachments \"A.pdf\", \"B.pdf\" and \"C.pdf\" \nmust be included in the request to [[HYPERLINK_A012]].\n2. Let us consider a different referral that has two referral letter attachments (say \"D.jpg\" and \"E.jpg\") \nalready associated, and you wish to remove one of them. Let us consider that you wish to remove \"D.jpg\". \nTo do this, you would call [[HYPERLINK_A012]] specifying only \"E.jpg\" in your request. By omitting \n\"D.jpg\" from your request, e-RS will disassociate attachment \"D.jpg\" from the referral and only attachment \"E.jpg\" \nwill remain associated.\n3. Let us now consider a referral that has four referral letter attachments associated (say \"L.doc\", \"M.doc\", \"N.doc\" \nand \"O.doc\"), and you wish to add some more files (say \"P.doc\" and \"Q.doc\") and remove some files (say \"N.doc\" \nand \"O.doc\"). To do this you must upload the additional attachment(s) (\"N.doc\" and \"O.doc\") \nusing [[HYPERLINK_A020]]. Following that successful upload, you must then associate only all \nreferral letter attachments the user wishes to keep (namely \"L.doc\", \"M.doc\", \"P.doc\" and \"Q.doc\") \nin a single request to [[HYPERLINK_A012]]. Attachments not included in the request \n(namely \"N.doc\" and \"O.doc\") will be disassociated from the referral as a result.\n\nAs a developer or software supplier, please ensure your users are made aware or protected from this behaviour. \nFor example, when a referring user wants to update the attachments on a referral, the user should be presented \nwith the currently associated attachments so they can add and/or remove attachments as required.\n\nNote: It is not permissible to remove *all* referral letter attachments leaving zero attachments associated. \nThere must be at least one referral letter attachment associated.\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use case\nAs an authenticated user\n\nI need to be able to manage referral letter attachments associated with a referral\n\nSo I can ensure the service provider has enough information to review/process the referral.\n\n\n## Related endpoints\nDocuments must be uploaded into the e-RS document store using [[HYPERLINK_A020]] before they can be associated \nwith a referral.\n\nYou can check to see what referral letter information has been added to a referral by using [[HYPERLINK_A005]], \n[[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment:\n\n| Scenario | Request |\n| ------------------------------------------------------ | ------------------------------------------------------- |\n| Add clinical information for first time (single file) | `ubrn`=`000000070000`, `body` as defined in example 1 |\n| Add clinical information for first time (two files) | `ubrn`=`000000070001`, `body` as defined in example 2 |\n| Update clinical information | `ubrn`=`000000070001`, `body` as defined in example 3 |\n", + "summary": "Maintain referral letter (A012, FHIR STU3)", + "operationId": "a012-maintain-referral-letter", + "tags": [ + "Refer patient", + "Arrange appointment", + "Arrange triage" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-MaintainReferralLetter-Parameters", + "description": "The parameters object used in maintain referral letter endpoint", + "type": "object", + "required": [ + "meta", + "resourceType", + "parameter" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-MaintainReferralLetter-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-MaintainReferralLetter-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `referralLetterFile` | `1..*` | |\n", + "items": { + "title": "referralLetterFile", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "referralLetterFile" + ], + "example": "referralLetterFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER" + ], + "example": "REFERRER" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "Blood test results showing an anomaly in the values of xxxx" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + } + } + } + }, + "examples": { + "single-file": { + "summary": "1 - Add clinical information (single file)", + "value": { + "$ref": "../../examples/maintainReferralLetter/requests/SingleDocumentReference.json" + } + }, + "two-files": { + "summary": "2 - Add clinical information (two files)", + "value": { + "$ref": "../../examples/maintainReferralLetter/requests/MultipleDocumentReferences.json" + } + }, + "update-files": { + "summary": "3 - Update clinical information (removing one file from example above)", + "value": { + "$ref": "../../examples/maintainReferralLetter/requests/UpdateClinicalInfo.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "withClinicalInformation": { + "summary": "`ReferralRequest` with clinical information (2 files)", + "value": { + "$ref": "../../../examples/maintainReferralLetter/responses/ReferralRequestWithMultipleDocumentReferences.json" + } + }, + "withClinicalInformationFirstTime": { + "summary": "`ReferralRequest` with clinical information (1 file)", + "value": { + "$ref": "../../../examples/maintainReferralLetter/responses/ReferralRequestWithSingleDocumentReference.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| NO_CHANGES_DETECTED | No changes detected when processing supplied request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.acceptReferral": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint, as a service provider, to accept a referral that is booked into your bookable service and awaiting review.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n### Application-restricted, unattended access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nTo access this endpoint in application-restricted, unattended mode, you will be required to submit your use case for review.\n\n## Important notes\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications. \n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. [[HYPERLINK_A013]] can only be used for referrals \nbooked into bookable services, and not the referrals sent into triage services.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\n## Use cases\nAs an authenticated user\n\nI need to accept an inbound referral after its review\n\nSo that I can confirm the patient's referral is appropriate for the current service and booked appointment date/time.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Accept referral (A013, FHIR STU3)", + "operationId": "a013-accept-referral", + "tags": [ + "Review referral requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + } + ], + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "example-response": { + "summary": "Example response", + "value": { + "$ref": "../../../examples/acceptReferral/responses/ExampleResponse.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.rejectReferral": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint, as a service provider, to reject a referral that is booked into your bookable service and awaiting review. \nThis returns the referral to the referrer with a mandatory rejection reason and optional user comment to explain why it has been rejected.\n\nConsider using [[HYPERLINK_A022]] instead if you wish to ask your admin team to get the patient into the most appropriate service.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. [[HYPERLINK_A014]] can only \nbe used for referrals booked into bookable services, and not the referrals sent into triage services.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\nYou need to use [[HYPERLINK_A004]] to retrieve a list of rejection reason reference data codes along with their user-friendly display names. To find \nrelevant rejection reasons, obtain reference data from `APPOINTMENT-CANCELLATION-REASON` and filter as follows:\n\n - `appointmentBookingCancellationReasonType` must be `PROVIDER_REJECT`\n - `effectiveFrom` must be in the past, and\n - `effectiveTo` must not be in the past\n\n## Important notes\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use cases\nAs an authenticated user\n\nI need to reject an inbound referral back to the referrer after its review with an explanation of why\n\nSo that the referrer can address the reason for rejection and progress the referral appropriately.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Reject referral (A014, FHIR STU3)", + "operationId": "a014-reject-referral", + "tags": [ + "Review referral requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-RejectReferral-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RejectReferral-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RejectReferral-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `rejectionReason` | `1..1` | The reason why the referral is being rejected |\n| `rejectionComments` | `0..1` | This may be mandatory if mandatory comment indicator is set to 'Yes' for the Rejection Reason Type selected. Maximum 2000 characters. |\n| `appointmentCancelledInPAS` | `0..1` | This flag is mandatory for indirectly bookable services | \n", + "items": { + "anyOf": [ + { + "title": "rejectionReason", + "description": "Parameter to supply a rejectionReason", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "rejectionReason" + ], + "example": "rejectionReason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "TREATMENT_NO_LONGER_REQUIRED" + } + } + } + } + }, + { + "title": "rejectionComments", + "description": "Parameter to supply the rejectionComments", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "rejectionComments" + ], + "example": "rejectionComments" + }, + "valueString": { + "type": "string", + "example": "Condition of the patient has improved. No further action needed" + } + } + }, + { + "title": "appointmentCancelledInPAS", + "description": "Parameter to supply a appointmentCancelledInPAS", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "appointmentCancelledInPAS" + ], + "example": "appointmentCancelledInPAS" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + } + ] + } + } + } + }, + "examples": { + "basic-example-ibs": { + "summary": "Basic example for IBS", + "value": { + "$ref": "../../examples/rejectReferral/requests/BasicExampleIbs.json" + } + }, + "basic-example-dbs": { + "summary": "Basic example for DBS", + "value": { + "$ref": "../../examples/rejectReferral/requests/BasicExampleDbs.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "example-response-ibs": { + "summary": "Example response for IBS", + "value": { + "$ref": "../../../examples/rejectReferral/responses/ExampleResponseIbs.json" + } + }, + "example-response-dbs": { + "summary": "Example response for DBS", + "value": { + "$ref": "../../../examples/rejectReferral/responses/ExampleResponseDbs.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNABLE_TO_CANCEL_APPOINTMENT | System is unable to cancel the appointment. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + }, + "504": { + "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "timeout", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_NOT_RESPONDING", + "display": "No response from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.generatePatientLetter": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to download a PDF format letter for the patient summarising the current state of their referral and any steps the patient may need to follow.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\n## Use case\n\nAs an authenticated user\n\nI need to generate the patient letter including up-to-date details about their referral and any steps the patient may need to follow\n\nSo that I can pass it to the patient.\n", + "summary": "Generate patient letter (A019, FHIR STU3)", + "operationId": "a019-generate-patient-letter", + "tags": [ + "Refer patient", + "Arrange appointment", + "Arrange triage" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "responses": { + "200": { + "description": "Response contains the binary stream of the generated patient letter.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Disposition": { + "description": "The description of the type of content provided.\n", + "required": true, + "schema": { + "type": "string", + "example": "attachment; filename=\"000000070000_Appointment_Confirmation_Summary_20210603121353.pdf\"" + } + }, + "Content-Length": { + "description": "The length of the response.\n", + "required": true, + "schema": { + "type": "string", + "example": "3111" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/pdf" + ], + "example": "application/pdf" + } + } + }, + "content": { + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_ACCESS_CODE | The patient does not have an access code/password to log onto the patient portal. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.cancelAppointmentActionLater": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint, as a service provider, to task your admin team to rebook/redirect a referral that is booked \ninto your bookable service and awaiting review.\n\nNote: this will also cancel the current appointment.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. [[HYPERLINK_A022]] can \nonly be used for referrals booked into bookable services, and not the referrals sent into triage services.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\nIf you want to include attachments with the admin task, you need to use [[HYPERLINK_A020]] so they are \nready to be associated when this endpoint is called.\n\n## Use cases\nAs an authenticated user\n\nI need to task my admin team to rebook/redirect a referral I have reviewed (whilst also cancelling the current appointment)\n\nSo that I can progress the patient's care along the most appropriate referral pathway.\n\n## Important notes\n - The priority of the referral can be changed as part of this endpoint.\n - A comment must be added to explain to the administrator what is required and can include optional attachments.\n - The current appointment is cancelled as part of this endpoint. If the current appointment is booked to an indirectly\n bookable service, you must indicate whether the appointment has been cancelled on the local provider system. \n If indicated as not cancelled, the referral will be added to the 'Indirectly Booked Appointments to Cancel in PAS' \n worklist to task the admin team to do so.\n - When this endpoint is successfully used, an entry will be added to the service providers 'Appointments For Booking' \n worklist for the admin team to action the task. The provider admin team will only be able to progress the referral \n via the e-RS Professional Application user interface (e.g. shortlisting appropriate services for the patient).\n - In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \n The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n - Further details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Cancel appointment, action later (A022, FHIR STU3)", + "operationId": "a022-cancel-appointment-action-later", + "tags": [ + "Review referral requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-cancelAppointmentActionLater-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-cancelAppointmentActionLater-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-cancelAppointmentActionLater-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------------------- |\n| `priority` | `0..1` | Optionally updates the priority |\n| `appointmentCancelledinPAS` | `0..1` | This flag is mandatory for indirectly bookable services |\n| `comments` | `1..1` | |\n| `providerAttachmentFile` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "description": "Parameter to supply a priority", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "appointmentCancelledInPAS", + "description": "Parameter to supply a appointmentCancelledInPAS", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "appointmentCancelledInPAS" + ], + "example": "appointmentCancelledInPAS" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "comments", + "description": "Parameter to supply the comments", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Please contact patient to rebook" + } + } + }, + { + "title": "providerAttachmentFile", + "description": "Parameter to supply an attachment file", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "providerAttachmentFile" + ], + "example": "providerAttachmentFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER" + ], + "example": "PROVIDER" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "basic-example-dbs": { + "summary": "Basic example for DBS", + "value": { + "$ref": "../../examples/cancelAppointmentActionLater/requests/MinimalExampleDBS.json" + } + }, + "example-priority-change-and-attachments": { + "summary": "Example for priority change and attachments", + "value": { + "$ref": "../../examples/cancelAppointmentActionLater/requests/PriorityChangeAndWithAttachmentsDBS.json" + } + }, + "basic-example-ibs": { + "summary": "Basic example for IBS", + "value": { + "$ref": "../../examples/cancelAppointmentActionLater/requests/MinimalExampleIBS.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "example-response-dbs": { + "summary": "Example response for DBS", + "value": { + "$ref": "../../../examples/cancelAppointmentActionLater/responses/MinimalExampleDBS.json" + } + }, + "example-priority-change-and-attachments": { + "summary": "Example response for priority change and attachments", + "value": { + "$ref": "../../../examples/cancelAppointmentActionLater/responses/PriorityChangeAndWithAttachmentsDBS.json" + } + }, + "example-response-ibs": { + "summary": "Example response for IBS", + "value": { + "$ref": "../../../examples/cancelAppointmentActionLater/responses/MinimalExampleIBS.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/CommunicationRequest/$ers.fetchworklist": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve available worklists of advice and guidance requests. Use [[HYPERLINK_A008]] to retrieve available worklists of referral requests.\n\nWorklists provide lists of referral/advice requests that meet certain criteria, typically where a user needs to be aware of something important, \nor to undertake an action, in order to avoid delays to patient care.\n\nService provider organisations can retrieve the contents of their 'Advice and guidance requests' worklist using \nthis endpoint. This worklist contains advice and guidance requests the provider has received and which need actioning. The version of each advice \nrequest 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.\n\nThere are currently no advice and guidance related worklists available for referring organisations.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nIf a worklist response exceeds 10MB, a successful response will not be returned. This is due to the size limitation on the APIM platform.\n\n## Use case\nAs an authenticated user\n\nI need to retrieve a worklist of advice and guidance requests\n\nSo I can determine which ones I need to take further action on.\n\n## Related endpoints\n\nHaving used this endpoint to retrieve the 'Advice and Guidance Requests' worklist, entries from it can be used as follows:\n - Use [[HYPERLINK_A024]] to retrieve contextual summary details of the advice and guidance request\n - Use [[HYPERLINK_A025]] to retrieve the conversation within the advice and guidance request, including references to attachments\n - Use [[HYPERLINK_A006]] to retrieve clinical attachments for an advice and guidance request\n - Use [[HYPERLINK_A026]] to respond to the referrer supplying advice or requesting further information\n - Use [[HYPERLINK_A027]] to convert the advice and guidance request into a referral. This is only possible if the referrer has authorised the provider to do so\n - Use [[HYPERLINK_A043]] to generate a PDF file overview relating to an advice and guidance request\n", + "summary": "Retrieve advice and guidance requests worklist (A023, FHIR STU3)", + "operationId": "a023-retrieve-a&g-worklist", + "tags": [ + "Review advice and guidance requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-FetchWorklist-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `listType` | `1..1` | |\n| `service` | `0..1` | Mandatory for the application-restricted security pattern |\n| `specialtyAssignedIndicator` | `0..1` | |\n| `specialty` | `0..1` | | \n| `location` | `0..1` | | \n| `clinicianAssignedIndicator` | `0..1` | | \n| `clinician` | `0..1` | | \n", + "items": { + "anyOf": [ + { + "title": "listType", + "description": "Indicates the type of list requested", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "listType" + ], + "example": "listType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| -------------------------------- | ----------- | -------------------------------------- |\n| `eRS-ReferralListSelector` | `0..1` | |\n| `eRS-CommunicationListSelector` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-ReferralListSelector", + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRALS_FOR_REVIEW", + "APPOINTMENT_SLOT_ISSUES", + "REJECTED_TRIAGE_RESPONSE", + "ASSESSMENT_RETURNED_CANCELLED_DNA", + "AWAITING_BOOKING", + "LETTERS_OUTSTANDING" + ], + "example": "REFERRALS_FOR_REVIEW" + } + } + }, + { + "title": "eRS-CommunicationListSelector", + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVICE_AND_GUIDANCE_REQUESTS" + ], + "example": "ADVICE_AND_GUIDANCE_REQUESTS" + } + } + } + ] + } + } + } + } + } + }, + { + "title": "service", + "description": "The service identifier", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + }, + { + "title": "specialtyAssignedIndicator", + "description": "Indicates whether filtering on Specialty is required or not\n", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialtyAssignedIndicator" + ], + "example": "specialtyAssignedIndicator" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + }, + "code": { + "type": "string", + "enum": [ + "ASSIGNED", + "NOT_ASSIGNED" + ], + "example": "NOT_ASSIGNED" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "location", + "description": "The service location identifier", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "location" + ], + "example": "location" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "clinicianAssignedIndicator", + "description": "Indicates whether filtering on Clinician is required or not\n", + "type": "object", + "required": [ + "name", + "valueCodeableConcept" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicianAssignedIndicator" + ], + "example": "clinicianAssignedIndicator" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" + }, + "code": { + "type": "string", + "enum": [ + "ASSIGNED", + "NOT_ASSIGNED" + ], + "example": "NOT_ASSIGNED" + } + } + } + } + } + } + } + }, + { + "title": "clinician", + "description": "The clinician assigned to the Referral Request. If present, the 'clinicianAssignedIndicator' parameter must be set to 'Assigned'", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinician" + ], + "example": "clinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "aAndg-requests": { + "summary": "Advice and guidance requests", + "value": { + "$ref": "../../examples/retrieveAdviceAndGuidanceWorklist/requests/MinimalAdviceAndGuidanceRequests.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "The response body contains the list of advice and guidance requests (if any) that match the search criteria provided", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-FetchWorklist-List", + "description": "A list of referrals representing the available worklist items", + "type": "object", + "required": [ + "meta", + "resourceType", + "status", + "mode" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------------------------------------------- |\n| `Practitioner` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n| `Patient` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n", + "items": { + "anyOf": [ + { + "title": "Practitioner", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "Practitioner-021600556514" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Practitioner" + ], + "example": "Practitioner" + }, + "identifier": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + }, + { + "title": "Patient", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "Patient-9912003888" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Patient" + ], + "example": "Patient" + }, + "identifier": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with referral details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070002" + } + } + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ----------------------------------------------------------- | ----------- | ------------------------------------------------------------- |\n| `Extension-eRS-ReferralsforReview-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AppointmentSlotIssues-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested | \n| `Extension-eRS-AdviceAndGuidanceRequests-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-RejectedTriageResponse-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AwaitingBooking-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-LettersOutstanding-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralsforReview-WorkListItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `requestContextStatus` | `1..1` | |\n| `clinicalInfoFirstSubmitted` | `0..1` | |\n| `clinicalInfoLastUpdated` | `0..1` | |\n| `appointmentStart` | `0..1` | |\n| `allocatedClinician` | `0..1` | |\n| `service` | `1..1` | |\n| `referralRequestVersion` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#Patient-9462979626" + } + } + } + } + }, + { + "title": "namedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#Practitioner-021600556514" + } + } + } + } + }, + { + "title": "eReferralPathwayStart", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "eReferralPathwayStart" + ], + "example": "eReferralPathwayStart" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "clinicalInfoPrinted", + "type": "object", + "required": [ + "url", + "valueBoolean" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoPrinted" + ], + "example": "clinicalInfoPrinted" + }, + "valueBoolean": { + "type": "boolean", + "example": false + } + } + }, + { + "title": "requestContextStatus", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "requestContextStatus" + ], + "example": "requestContextStatus" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "LETTER_CHANGED", + "PRIORITY_CHANGED", + "PRIORITY_AND_LETTER_CHANGED", + "NEVER_REVIEWED" + ], + "example": "NEVER_REVIEWED" + }, + "display": { + "type": "string", + "example": "Never Reviewed" + } + } + } + } + } + } + } + }, + { + "title": "clinicalInfoFirstSubmitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoFirstSubmitted" + ], + "example": "clinicalInfoFirstSubmitted" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "clinicalInfoLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoLastUpdated" + ], + "example": "clinicalInfoLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-03T10:44:42.764Z" + } + } + }, + { + "title": "referralType", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralType" + ], + "example": "referralType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" + }, + "code": { + "type": "string", + "enum": [ + "APPOINTMENT", + "TRIAGE_DEFERRAL" + ], + "example": "TRIAGE_DEFERRAL" + } + } + } + } + } + } + } + }, + { + "title": "appointmentStart", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "appointmentStart" + ], + "example": "appointmentStart" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-02T14:15:00.000Z" + } + } + }, + { + "title": "allocatedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "allocatedClinician" + ], + "example": "allocatedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#Practitioner-021600556514" + } + } + } + } + }, + { + "title": "service", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Service Name" + } + } + } + } + }, + { + "title": "referralRequestVersion", + "type": "object", + "required": [ + "url", + "valueInteger" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralRequestVersion" + ], + "example": "referralRequestVersion" + }, + "valueInteger": { + "type": "integer", + "example": 0 + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AppointmentSlotIssues-WorkListItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `ubrnReceived` | `0..1` | |\n| `patientContactExpected` | `0..1` | |\n| `clinicalInformationStatus` | `0..1` | |\n| `reason` | `0..1` | |\n| `lastContact` | `0..1` | |\n| `service` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "namedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "eReferralPathwayStart", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "eReferralPathwayStart" + ], + "example": "eReferralPathwayStart" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "clinicalInfoPrinted", + "type": "object", + "required": [ + "url", + "valueBoolean" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInfoPrinted" + ], + "example": "clinicalInfoPrinted" + }, + "valueBoolean": { + "type": "boolean", + "example": false + } + } + }, + { + "title": "ubrnReceived", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "ubrnReceived" + ], + "example": "ubrnReceived" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "patientContactExpected", + "type": "object", + "required": [ + "url", + "valueDate" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patientContactExpected" + ], + "example": "patientContactExpected" + }, + "valueDate": { + "type": "string", + "format": "date", + "example": "2021-09-07" + } + } + }, + { + "title": "clinicalInformationStatus", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalInformationStatus" + ], + "example": "clinicalInformationStatus" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PRESENT", + "NOT_APPLICABLE", + "NOT_DUE", + "OVERDUE" + ], + "example": "NOT_DUE" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + } + } + } + } + } + }, + { + "title": "lastContact", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "lastContact" + ], + "example": "lastContact" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "service", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Service Name" + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AdviceAndGuidanceRequests-WorkListItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `category` | `1..1` | |\n| `adviceFirstRequested` | `1..1` | |\n| `adviceLastUpdated` | `1..1` | |\n| `referrer` | `1..1` | |\n| `service` | `1..1` | |\n| `clinicType` | `0..1` | |\n| `communicationRequestVersion` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "specialty", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + } + } + } + }, + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "namedClinician", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "category", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "category" + ], + "example": "category" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_RESPONSE_REQUIRED", + "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", + "REFERRER_TO_REVIEW_RESPONSE", + "CONVERSATION_ENDED_CANCELLED", + "CONVERSATION_ENDED_CLOSED", + "ADVICE_CONVERTED" + ], + "example": "PROVIDER_RESPONSE_REQUIRED" + } + } + } + } + } + } + } + }, + { + "title": "adviceFirstRequested", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "adviceFirstRequested" + ], + "example": "adviceFirstRequested" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "adviceLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "adviceLastUpdated" + ], + "example": "adviceLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "adviceLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "adviceLastUpdated" + ], + "example": "adviceLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-09-01T14:26:18.314Z" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "service", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "service" + ], + "example": "service" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier", + "display" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Service Name" + } + } + } + } + }, + { + "title": "clinicType", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/CLINIC-TYPE" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + } + } + } + }, + { + "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": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Rejected/TriageRequest worklist, only included if `status` is `TRIAGE_RESPONSE` |\n", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "referralLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLastUpdated" + ], + "example": "referralLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "status", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "status" + ], + "example": "status" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "ASSESSMENT_RESULT", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "NOT_BOOKED", + "BOOKED", + "AWAITING_TRIAGE", + "DEFERRED_TO_PROVIDER", + "APP_CANCELLED_BY_PROVIDER", + "APP_CANCELLED_BY_PATIENT", + "TRIAGED_PROVIDER_TO_ACTION", + "TRIAGE_RESPONSE" + ], + "example": "REJECTED" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Assessment result", + "Cancelled referral", + "Did not attend", + "Not booked", + "Booked", + "Awaiting triage", + "Deferred to provider", + "Appointment cancelled by provider", + "Appointment cancelled by patient", + "Triaged - provider to action", + "Triage Response" + ], + "example": "Rejected" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + ], + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "FURTHER_INFORMATION_REQUIRED" + }, + "display": { + "type": "string", + "example": "Further information required" + } + } + } + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" + }, + "extension": { + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Assessment Returned / Cancelled / DNA worklist, only included if `status` is `CANCELLED_REFERRAL` |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "referralLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLastUpdated" + ], + "example": "referralLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "status", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "status" + ], + "example": "status" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "ASSESSMENT_RESULT", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "NOT_BOOKED", + "BOOKED", + "AWAITING_TRIAGE", + "DEFERRED_TO_PROVIDER", + "APP_CANCELLED_BY_PROVIDER", + "APP_CANCELLED_BY_PATIENT", + "TRIAGED_PROVIDER_TO_ACTION", + "TRIAGE_RESPONSE" + ], + "example": "REJECTED" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Assessment result", + "Cancelled referral", + "Did not attend", + "Not booked", + "Booked", + "Awaiting triage", + "Deferred to provider", + "Appointment cancelled by provider", + "Appointment cancelled by patient", + "Triaged - provider to action", + "Triage Response" + ], + "example": "Rejected" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" + ], + "example": "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "INTEND_PRIVATE" + }, + "display": { + "type": "string", + "example": "Patient will go to a private clinic" + } + } + } + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-AwaitingBooking-WorklistItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" + }, + "extension": { + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Awaiting Booking worklist, only included if `status` is `APPOINTMENT_CANCELLED_BY_PROVIDER` or `APPOINTMENT_CANCELLED_BY_PATIENT` |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "referralLastUpdated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralLastUpdated" + ], + "example": "referralLastUpdated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "status", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "status" + ], + "example": "status" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "ASSESSMENT_RESULT", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "NOT_BOOKED", + "BOOKED", + "AWAITING_TRIAGE", + "DEFERRED_TO_PROVIDER", + "APP_CANCELLED_BY_PROVIDER", + "APP_CANCELLED_BY_PATIENT", + "TRIAGED_PROVIDER_TO_ACTION", + "TRIAGE_RESPONSE" + ], + "example": "REJECTED" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Assessment result", + "Cancelled referral", + "Did not attend", + "Not booked", + "Booked", + "Awaiting triage", + "Deferred to provider", + "Appointment cancelled by provider", + "Appointment cancelled by patient", + "Triaged - provider to action", + "Triage Response" + ], + "example": "Rejected" + } + } + } + } + } + } + } + }, + { + "title": "reason", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + ], + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_APPOINTMENT_CLASH" + }, + "display": { + "type": "string", + "example": "Patient - Clashes with another appointment" + } + } + } + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-LettersOutstanding-WorklistItem", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" + }, + "extension": { + "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `letterDue` | `1..1` | The `date` a referral letter is due for the `ReferralRequest` |\n", + "type": "array", + "items": { + "anyOf": [ + { + "title": "patient", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + { + "title": "priority", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "referralCreated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referralCreated" + ], + "example": "referralCreated" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-11-24T14:46:01.001Z" + } + } + }, + { + "title": "clinicalContext", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "clinicalContext" + ], + "example": "clinicalContext" + }, + "valueString": { + "type": "string", + "example": "ORTHAPEDICS/KNEE" + } + } + }, + { + "title": "referrer", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "referrer" + ], + "example": "referrer" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "letterDue", + "type": "object", + "required": [ + "url", + "valueDate" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "letterDue" + ], + "example": "letterDue" + }, + "valueDate": { + "type": "string", + "format": "date", + "example": "2021-11-24" + } + } + } + ] + } + } + } + } + ] + } + } + } + } + } + } + }, + "examples": { + "aAndg-requests": { + "summary": "Advice and guidance requests", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceWorklist/responses/AdviceAndGuidanceRequests.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request or service. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/CommunicationRequest/{ubrn}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve the summary of an advice and guidance request. This endpoint provides important \ncontextual information about the advice and guidance request (e.g. the service/specialty to which advice has been requested, etc).\n\nThis does not include the advice and guidance conversation between the referrer and the service provider. The conversation must be retrieved via [[HYPERLINK_A025]].\n\nAn advice request can include file attachments and structured clinical data added via an integrated primary care system. These must be retrieved via [[HYPERLINK_A042]] and [[HYPERLINK_A043]], respectively.\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of the advice and guidance request. \nFor service provider users, you may have identified the UBRN via [[HYPERLINK_A023]].\n \n## Application-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n## Healthcare worker, user-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve the summary of an advice and guidance request\n\nSo I can understand all of the relevant context for the request.\n\n## Important notes\n\nThe summary includes an indicator of whether the referrer has authorised the providing organisation to \nconvert the advice and guidance request into an appointment request. \nIf authorised, [[HYPERLINK_A027]] can be used to convert the advice and guidance request into an appointment request.\n\nAn advice and guidance request may have been converted to a referral (with the same UBRN), \nand in addition a referral pathway in e-RS can be made up of more than one UBRN. As such, \nit is important that all clinical information is obtained across all the related UBRNs in the pathway. \nThese may be identified using [[HYPERLINK_A005]] and will be returned if the user is authorised to view this.\n\nIf the converted advice and guidance request is referred to a service outside of your organisation, \nthe subsequent referral information may not be accessible due to existing data-access rules. However, \nthe advice and guidance summary ([[HYPERLINK_A024]]), attachments ([[HYPERLINK_A006]]), advice and guidance conversation ([[HYPERLINK_A025]]) and \nclinical information ([[HYPERLINK_A043]]) which took place before such a conversion still forms part of the clinical information and can still be retrieved.\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or [[HYPERLINK_A006]] endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A024]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE\t | The file is available for download. |\n| PENDING\t | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. |\n| THREATS_FOUND\t | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n## Related endpoints\n\nAfter using this endpoint, use [[HYPERLINK_A025]] to retrieve the Advice and Guidance conversation itself.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ----------------------- |\n| Simple summary `CommunicationRequest` | `ubrn`=`000000070000` |\n| Attachment file reference present | `ubrn`=`000000070001` |\n| Attachment files unavailable for download | `ubrn`=`000000070002` |\n", + "summary": "Retrieve advice and guidance request summary (A024, FHIR STU3)", + "operationId": "a024-retrieve-advice-and-guidance", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "e-RS Communication Request (advice and guidance summary)", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CommunicationRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "category", + "subject", + "recipient", + "sender", + "requester", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "CommunicationRequest" + ], + "example": "CommunicationRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + }, + { + "title": "CareConnect-PractitionerRole", + "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "practitioner", + "organization" + ], + "properties": { + "id": { + "type": "string", + "example": "PractitionerRole-R69-000000000101" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "PractitionerRole" + ], + "example": "PractitionerRole" + }, + "practitioner": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "organization": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + "code": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ProviderConversionAuthorisation", + "description": "Extension to supply the conversion authorisation flag", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + }, + "code": { + "type": "string", + "enum": [ + "AUTHORISED_TO_CONVERT", + "NOT_AUTHORISED_TO_CONVERT" + ], + "example": "NOT_AUTHORISED_TO_CONVERT" + }, + "display": { + "type": "string", + "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" + } + } + } + } + }, + { + "title": "Extension-eRS-Specialty", + "description": "Extension to supply the specialty", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "category": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_RESPONSE_REQUIRED", + "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", + "REFERRER_TO_REVIEW_RESPONSE", + "CONVERSATION_ENDED_CANCELLED", + "CONVERSATION_ENDED_CLOSED", + "ADVICE_CONVERTED" + ], + "example": "PROVIDER_RESPONSE_REQUIRED" + } + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "recipient": { + "type": "array", + "items": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + } + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "requester": { + "type": "object", + "required": [ + "agent" + ], + "properties": { + "agent": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70002" + } + } + } + } + } + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "minimal": { + "summary": "Minimal `CommunicationRequest` example", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/MinimalExample.json" + } + }, + "with-attachment-file-reference": { + "summary": "`CommunicationRequest` with attachment file reference", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithAttachmentFileReference.json" + } + }, + "with-unavailable-attachments": { + "summary": "`CommunicationRequest` with attachments unavailable for download", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithUnavailableAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an Advice and Guidance request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/CommunicationRequest/{ubrn}/_history/{version}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to retrieve a specific version of `CommunicationRequest`.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nThe pre-requisites for this endpoint are the same as for endpoint [[HYPERLINK_A024]].\n\nNote: e-RS only supports the retrieval of the most recent version of `CommunicationRequest`. You cannot retrieve earlier versions.\n\n## Important note\n\nThe Important notes for this endpoint are the same as for endpoint [[HYPERLINK_A024]].\n\n## Use case\n\nSee [[HYPERLINK_A005]].\n\n## Related endpoints\n\nSee [[HYPERLINK_A024]].\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ------------------------------------- |\n| Simple summary `CommunicationRequest` | `ubrn`=`000000070000`, `version`=`5` |\n| Attachment file reference present | `ubrn`=`000000070001`, `version`=`5` |\n| `CommunicationRequest` with attachments unavailable for download | `ubrn`=`000000070002`, `version`=`5` |\n", + "summary": "Retrieve advice and guidance request summary (versioned) (A024, FHIR STU3)", + "operationId": "a024-retrieve-advice-and-guidance-versioned", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "name": "version", + "in": "path", + "description": "The version of the resource to be retrieved. It must be the latest version of the resource otherwise\n`HISTORY_NOT_SUPPORTED` error will be returned (HTTP 404 Not Found).\n", + "required": true, + "schema": { + "type": "string", + "example": "5" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "e-RS Communication Request (advice and guidance summary)", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CommunicationRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "category", + "subject", + "recipient", + "sender", + "requester", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "CommunicationRequest" + ], + "example": "CommunicationRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + }, + { + "title": "CareConnect-PractitionerRole", + "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "practitioner", + "organization" + ], + "properties": { + "id": { + "type": "string", + "example": "PractitionerRole-R69-000000000101" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "PractitionerRole" + ], + "example": "PractitionerRole" + }, + "practitioner": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "organization": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + "code": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ProviderConversionAuthorisation", + "description": "Extension to supply the conversion authorisation flag", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + }, + "code": { + "type": "string", + "enum": [ + "AUTHORISED_TO_CONVERT", + "NOT_AUTHORISED_TO_CONVERT" + ], + "example": "NOT_AUTHORISED_TO_CONVERT" + }, + "display": { + "type": "string", + "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" + } + } + } + } + }, + { + "title": "Extension-eRS-Specialty", + "description": "Extension to supply the specialty", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "category": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_RESPONSE_REQUIRED", + "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", + "REFERRER_TO_REVIEW_RESPONSE", + "CONVERSATION_ENDED_CANCELLED", + "CONVERSATION_ENDED_CLOSED", + "ADVICE_CONVERTED" + ], + "example": "PROVIDER_RESPONSE_REQUIRED" + } + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "recipient": { + "type": "array", + "items": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + } + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "requester": { + "type": "object", + "required": [ + "agent" + ], + "properties": { + "agent": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70002" + } + } + } + } + } + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "minimal": { + "summary": "Minimal `CommunicationRequest` example", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/MinimalExample.json" + } + }, + "with-attachment-file-reference": { + "summary": "`CommunicationRequest` with attachment file reference", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithAttachmentFileReference.json" + } + }, + "with-unavailable-attachments": { + "summary": "`CommunicationRequest` with attachments unavailable for download", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithUnavailableAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found - Resource not found for ID provided or Resource version does not match version requested." + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an Advice and Guidance request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Communication": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve the advice and guidance conversation between the referring organisation \nand service providing organisation.\n\nA conversation takes the form of messages between a referrer (seeking advice) and a provider or specialist. Messages can include file attachments. These must be retrieved via [[HYPERLINK_A042]]\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of the advice and guidance request. For service provider users, \nyou may have identified the UBRN via [[HYPERLINK_A023]].\n\nYou need to use [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request. \nThis will importantly include the latest version of the request which must be used.\n\n## Application-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n## Healthcare worker, user-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve the conversation that is present on an advice and guidance request\n\nSo that I can review the conversation and potentially contribute further to it.\n\n## Important notes\n\nThe conversation returned includes links to any attachments associated with the conversation.\nThis can be done via endpoint [[HYPERLINK_A006]]. \nNote, dependent on how attachments were added they may be linked to the Advice and Guidance summary instead of the conversation. \nThese may be retrieved from [[HYPERLINK_A024]].\n\nIf the converted advice and guidance request is referred to a service outside of your organisation, \nthe subsequent referral information may not be accessible due to existing data-access rules. \nHowever, the advice and guidance summary ([[HYPERLINK_A024]]), attachments ([[HYPERLINK_A006]]), \nadvice and guidance conversation ([[HYPERLINK_A025]]) and \nclinical information ([[HYPERLINK_A043]]) which took place before such a conversion still forms part of the clinical information and can still be retrieved.\nThe conversation also gets included in the form of a PDF file returned by [[HYPERLINK_A007]].\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A025]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE\t | The file is available for download. |\n| PENDING\t | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. |\n| THREATS_FOUND\t | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n\n\n## Related endpoints\n\nAfter using this endpoint:\n - Use [[HYPERLINK_A006]] to retrieve any attachments associated with the advice and guidance request.\n - (For service provider users) Use [[HYPERLINK_A026]] to respond to the referrer supplying advice or requesting further information.\n - (For service provider users) Use [[HYPERLINK_A027]] to convert the advice and guidance request into a referral. This is only possible if the referrer has authorised the provider to do so.\n\nUse [[HYPERLINK_A043]] to generate a PDF file overview relating to an advice and guidance request.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| -------------------------------------------------------------- | --------------------------------------------------------- |\n| Single message from referrer | `based-on`=`CommunicationRequest/000000070000/_history/1` |\n| One message each way | `based-on`=`CommunicationRequest/000000070000/_history/2` |\n| Attachment present in each direction | `based-on`=`CommunicationRequest/000000070001/_history/6` |\n| Multi-way conversation | `based-on`=`CommunicationRequest/000000070002/_history/1` |\n| Attachment uploaded from RCS before A&G creation | `based-on`=`CommunicationRequest/000000070003/_history/7` | \n| Attachment files unavailable for download | `based-on`=`CommunicationRequest/000000070004/_history/3` | \n", + "summary": "Retrieve advice and guidance conversation (A025, FHIR STU3)", + "operationId": "a025-retrieve-advice-and-guidance-conversation", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "name": "based-on", + "in": "query", + "description": "The component describing the CommunicationRequest for which the communication is requested for.\n\nPattern:\n\n`CommunicationRequest/{ubrn}/_history/{version}`\n\n - The `ubrn` represents the unique booking reference number of the Advice and Guidance Request for which the caller is obtaining the 'Advice and Guidance Conversation'\n - The `version` is the version of the A&G Request to be retrieved (only the most current version will be retrievable)\n", + "required": true, + "schema": { + "type": "string", + "example": "CommunicationRequest/000000070000/_history/1" + } + }, + { + "in": "query", + "name": "_include", + "description": "Suppliers must request includes they rely on. The default includes behaviour is subject to change. \n\nPlease note that '_include' query parameter can be supplied multiple times for example:\n\n`GET /STU3/Communication\n?based-on=CommunicationRequest/{ubrn}/_history/{version}\n&_include=Communication:requester-practitionerrole:PractitionerRole\n&_include=Communication:sender-practitionerrole:PractionerRole\n&_include=Communication:content-reference:DocumentReference`\n", + "required": false, + "schema": { + "type": "string", + "enum": [ + "Communication:requester-practitionerrole:PractitionerRole", + "Communication:sender-practitionerrole:PractionerRole", + "Communication:content-reference:DocumentReference" + ], + "example": "Communication:requester-practitionerrole:PractitionerRole" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "e-RS Communication Request (advice and guidance summary)", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "Bundle resource containing advice and guidance conversation", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "type", + "total", + "link", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "08acc887-6a7b-4b38-8f50-022e41319efe" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated", + "profile" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" + ], + "example": "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Bundle" + ], + "example": "Bundle" + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "total": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 3 + }, + "link": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/STU3/Communication?based-on=CommunicationRequest%2F000000070000%2F_history%2F6&_include=Communication%3Arequester-practitionerrole%3APractitionerRole&_include=Communication%3Asender-practitionerrole%3APractionerRole&_include=Communication%3Acontent-reference%3ADocumentReference" + } + } + } + }, + "entry": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ----------------------- | ----------- | --------------------------------------------------- |\n| `CommunicationEntry` | `1..*` | |\n| `PractitionerRoleEntry` | `2..*` | |\n| `DocumentEntry` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "CommunicationEntry", + "description": "CommunicationEntry details a single chat entry.\n", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/STU3/Communication/70000" + }, + "resource": { + "title": "eRS-Communication-1", + "description": "A record of information transmitted from a sender to a receiver", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "category", + "recipient", + "sent", + "sender", + "note" + ], + "properties": { + "id": { + "type": "string", + "example": "appointment" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/eRS-Communication-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Communication" + ], + "example": "Communication" + }, + "status": { + "type": "string", + "enum": [ + "completed" + ], + "example": "completed" + }, + "category": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" + }, + "code": { + "type": "string", + "enum": [ + "REQUESTER", + "RESPONDER", + "REFERRER_CLINICAL_INFORMATION_UPDATED" + ], + "example": "REQUESTER" + } + } + } + } + } + } + }, + "recipient": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + }, + { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + ] + } + }, + "sent": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "DocumentReference/70000" + } + } + } + } + } + }, + "note": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "text" + ], + "properties": { + "text": { + "type": "string", + "example": "Example content...", + "description": "Maximum 8000 characters." + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + } + } + }, + { + "title": "PractitionerRoleEntry", + "description": "PractitionerRoleEntry details practitioner involved in this conversation.\n", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/STU3/PractitionerRole/103264994981.R69.SERVICE-PROVIDER-CLINICIAN" + }, + "resource": { + "title": "CareConnect-PractitionerRole", + "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "practitioner", + "organization" + ], + "properties": { + "id": { + "type": "string", + "example": "PractitionerRole-R69-000000000101" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "PractitionerRole" + ], + "example": "PractitionerRole" + }, + "practitioner": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "organization": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + "code": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "include" + ], + "example": "include" + } + } + } + } + }, + { + "title": "DocumentEntry", + "description": "DocumentEntry contains the 'DocumentReference' associated with this advice and guidance conversation.\n", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/STU3/DocumentReference/70000" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "include" + ], + "example": "include" + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "single-message-from-referrer": { + "summary": "Single message from referrer", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/SingleMessageFromReferrer.json" + } + }, + "one-message-each-way": { + "summary": "One message each way", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/OneMessageEachWay.json" + } + }, + "attachment-present-in-each-direction": { + "summary": "Attachment present in each direction", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/AttachmentPresentInEachDirection.json" + } + }, + "multi-way-conversation": { + "summary": "Multi-way conversation", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/MultiWayConversation.json" + } + }, + "attachment-uploaded-from-rcs": { + "summary": "Attachment uploaded from RCS", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/AttachmentUploadedFromRCS.json" + } + }, + "unavailable-attachments": { + "summary": "Attachment files unavailable for download", + "value": { + "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/UnavailableAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found - Resource not found for ID provided or Resource version does not match version requested." + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/CommunicationRequest/{ubrn}/$ers.sendCommunicationToRequester": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint, as a service provider, to respond to an advice and guidance request your service provider organisation has received. \nYou can either provide guidance back to the referrer or request further information from the referrer. \nThis will return the advice and guidance request back to the referrer for action.\n\nNote: If you want to convert an advice and guidance request into a referral, \nand provide a final guidance response back to the referrer at the same time, please \nuse [[HYPERLINK_A027]] instead. This option is only permissible \nif the referrer has authorised the provider to convert the advice and guidance request into a referral.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request.\n\nYou need to use [[HYPERLINK_A025]] to retrieve the conversation within an advice and guidance request.\n\nIf you want to include attachments with the response, you need to use [[HYPERLINK_A020]] so they are ready to be associated with the response.\n\n## Important notes\n \nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download.\nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n \nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use case\nAs an authenticated user\n\nI need to return an advice and guidance request back to the referrer with some guidance\n\nSo that I can progress the conversation regarding the patient's care.\n\n## Related endpoints\n\nYou can use [[HYPERLINK_A007]] to generate a PDF file that summarises \nthe advice and guidance request and associated conversation.\n\nYou can use [[HYPERLINK_A024]] to retrieve the latest summary of the advice and guidance request.\n\nYou can use [[HYPERLINK_A025]] to retrieve the latest conversation within the advice and guidance request.\n", + "summary": "Send advice and guidance response (A026, FHIR STU3)", + "operationId": "a026-send-a&g-response", + "tags": [ + "Review advice and guidance requests" + ], + "parameters": [ + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-SendCommunicationToRequester-Request-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Request-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Request-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------------------------------------------------ |\n| `guidanceOutcome` | `1..1` | |\n| `guidanceIntendedRecommendation` | `0..1` | Conditionally Mandatory if guidanceOutcome value is `RETURN_TO_REFERRER_WITH_ADVICE` |\n| `guidance` | `1..1` | Mandatory guidance response. Maximum 8000 characters. |\n| `updatedPriority` | `1..1` | | \n| `guidanceAttachmentFile` | `0..*` | Property defining files to be included with the supplied `guidance` text | \n", + "items": { + "anyOf": [ + { + "title": "guidanceOutcome", + "description": "Parameter indicating the expected outcome of the supplied guidance", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "guidanceOutcome" + ], + "example": "guidanceOutcome" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceResponseOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceResponseOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "RETURN_TO_REFERRER_WITH_ADVICE", + "REQUIRE_FURTHER_INFORMATION", + "PROVIDER_CONVERTED" + ], + "example": "RETURN_TO_REFERRER_WITH_ADVICE" + } + } + } + } + }, + { + "title": "guidanceIntendedRecommendation", + "description": "Parameter to supply the recommendation for a patient's care off the back of the provided guidance. Only available and mandatory when supplying a `guidanceOutcome` of `RETURN_TO_REFERRER_WITH_ADVICE`", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "guidanceIntendedRecommendation" + ], + "example": "guidanceIntendedRecommendation" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceIntendedRecommendation-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceIntendedRecommendation-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVICE_ONLY_NO_REFERRAL_RECOMMENDED", + "ADVICE_FOLLOWED_BY_REFERRAL_IF_REQUIRED", + "REFERRAL_RECOMMENDED", + "OTHER" + ], + "example": "ADVICE_ONLY_NO_REFERRAL_RECOMMENDED" + } + } + } + } + }, + { + "title": "guidance", + "description": "Parameter to supply the guidance", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "guidance" + ], + "example": "guidance" + }, + "valueString": { + "type": "string", + "example": "Please perform test B and send me back the results" + } + } + }, + { + "title": "updatedPriority", + "description": "Parameter to supply a updatedPriority", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "updatedPriority" + ], + "example": "updatedPriority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "guidanceAttachmentFile", + "description": "Parameter to supply an attachment file", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "guidanceAttachmentFile" + ], + "example": "guidanceAttachmentFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "GUIDANCE_RESPONSE" + ], + "example": "GUIDANCE_RESPONSE" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "require-further-information": { + "summary": "Require further information", + "value": { + "$ref": "../../examples/sendAdviceAndGuidanceResponse/requests/RequireFurtherInformation.json" + } + }, + "return-to-referrer-with-advice": { + "summary": "Return to referrer with advice", + "value": { + "$ref": "../../examples/sendAdviceAndGuidanceResponse/requests/ReturnToReferrerWithAdvice.json" + } + }, + "attachment-included": { + "summary": "Attachment included", + "value": { + "$ref": "../../examples/sendAdviceAndGuidanceResponse/requests/AttachmentIncluded.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Parameters resource containing updated communication request and newly created communication", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-SendCommunicationToRequester-Response-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Response-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Response-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `updatedCommunicationRequest` | `1..1` | |\n| `createdCommunication` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "updatedCommunicationRequest", + "description": "Parameter containing the updated `CommunicationRequest` detailing changes to the overall conversation (changes to priority, status, etc)", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "updatedCommunicationRequest" + ], + "example": "updatedCommunicationRequest" + }, + "resource": { + "title": "eRS-CommunicationRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "category", + "subject", + "recipient", + "sender", + "requester", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "CommunicationRequest" + ], + "example": "CommunicationRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + }, + { + "title": "CareConnect-PractitionerRole", + "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "practitioner", + "organization" + ], + "properties": { + "id": { + "type": "string", + "example": "PractitionerRole-R69-000000000101" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "PractitionerRole" + ], + "example": "PractitionerRole" + }, + "practitioner": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "organization": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + "code": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ProviderConversionAuthorisation", + "description": "Extension to supply the conversion authorisation flag", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + }, + "code": { + "type": "string", + "enum": [ + "AUTHORISED_TO_CONVERT", + "NOT_AUTHORISED_TO_CONVERT" + ], + "example": "NOT_AUTHORISED_TO_CONVERT" + }, + "display": { + "type": "string", + "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" + } + } + } + } + }, + { + "title": "Extension-eRS-Specialty", + "description": "Extension to supply the specialty", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "category": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_RESPONSE_REQUIRED", + "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", + "REFERRER_TO_REVIEW_RESPONSE", + "CONVERSATION_ENDED_CANCELLED", + "CONVERSATION_ENDED_CLOSED", + "ADVICE_CONVERTED" + ], + "example": "PROVIDER_RESPONSE_REQUIRED" + } + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "recipient": { + "type": "array", + "items": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + } + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "requester": { + "type": "object", + "required": [ + "agent" + ], + "properties": { + "agent": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70002" + } + } + } + } + } + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + } + } + }, + { + "title": "createdCommunication", + "description": "Parameter containing the newly created `Communication` detailing the guidance provided", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "createdCommunication" + ], + "example": "createdCommunication" + }, + "resource": { + "title": "eRS-Communication-1", + "description": "A record of information transmitted from a sender to a receiver", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "category", + "recipient", + "sent", + "sender", + "note" + ], + "properties": { + "id": { + "type": "string", + "example": "appointment" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/eRS-Communication-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Communication" + ], + "example": "Communication" + }, + "status": { + "type": "string", + "enum": [ + "completed" + ], + "example": "completed" + }, + "category": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" + }, + "code": { + "type": "string", + "enum": [ + "REQUESTER", + "RESPONDER", + "REFERRER_CLINICAL_INFORMATION_UPDATED" + ], + "example": "REQUESTER" + } + } + } + } + } + } + }, + "recipient": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + }, + { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + ] + } + }, + "sent": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "DocumentReference/70000" + } + } + } + } + } + }, + "note": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "text" + ], + "properties": { + "text": { + "type": "string", + "example": "Example content...", + "description": "Maximum 8000 characters." + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "require-further-information": { + "summary": "Response for 'Require further information'", + "value": { + "$ref": "../../../examples/sendAdviceAndGuidanceResponse/responses/RequireFurtherInformation.json" + } + }, + "return-to-referrer-with-advice": { + "summary": "Response for 'Return to referrer with advice'", + "value": { + "$ref": "../../../examples/sendAdviceAndGuidanceResponse/responses/ReturnToReferrerWithAdvice.json" + } + }, + "with-attachment": { + "summary": "Response with attachment", + "value": { + "$ref": "../../../examples/sendAdviceAndGuidanceResponse/responses/AttachmentIncluded.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNSUPPORTED_PRIORITY | The Priority submitted is not supported by the responsible Service. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/$ers.createFromCommunicationRequestActionLater": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint, as a service provider, to:\n - convert the advice and guidance request you have received into a referral, AND\n - create a task for the service provider admin team to select/shortlist appropriate services for the patient, AND\n - provide final guidance response details back to the referrer\n\nNote: This endpoint is only allowed to be used if the referrer has authorised the provider to convert the advice \nand guidance request into a referral.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request. \nThis will include whether or not the referrer has authorised the provider to be able to convert an \nadvice and guidance request into a referral, and thus dictate whether this endpoint can be used.\n\nYou need to use [[HYPERLINK_A025]] to retrieve the conversation within an advice and guidance request.\n\nIf you want to include attachments with the admin task and/or the response to the referrer, \nyou need to use [[HYPERLINK_A020]] so they are ready to be associated when this endpoint is called.\n\n## Use case\nAs an authenticated user\n\nI need to convert an inbound advice and guidance request into a referral \nand task my admin team to shortlist appropriate services for the patient\n\nSo that I can progress the patient's care along the most appropriate referral pathway.\n\n## Important notes\n\nWhen this endpoint is successfully used, an entry will be added to the service providers \nAppointments For Booking worklist for the admin team to action the task. The provider \nadmin team will currently only be able to progress the referral via the e-RS Professional \nApplication user interface (e.g. shortlisting appropriate services for the patient).\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Related endpoints\n\nYou can use [[HYPERLINK_A005]] to retrieve the details of the referral.\n\nYou can use [[HYPERLINK_A024]] to retrieve the latest summary of the advice and guidance request.\n\nYou can use [[HYPERLINK_A025]] to retrieve the latest conversation within the advice and guidance request.\n\nYou can use [[HYPERLINK_A006]] to retrieve the clinical attachments for a referral/advice request.\n\nYou can use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for a referral.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Convert advice and guidance request to referral (A027, FHIR STU3)", + "operationId": "a027-convert-a&g-to-referral", + "tags": [ + "Review advice and guidance requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CreateFromCommunicationRequestActionLater-Request-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateFromCommunicationRequestActionLater-Request-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateFromCommunicationRequestActionLater-Request-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------------- |\n| `createFrom` | `1..1` | |\n| `guidance` | `1..1` | Mandatory guidance response. Maximum 8000 characters. |\n| `newReferralPriority` | `1..1` | | \n| `reviewComments` | `1..1` | |\n| `guidanceAttachmentFile` | `0..*` | Property defining files to be included with the supplied `guidance` text | \n| `reviewAttachmentFile` | `0..*` | Property defining files to be associated with the created `ReferralRequest` | \n", + "items": { + "anyOf": [ + { + "title": "createFrom", + "description": "Parameter to supply a createFrom", + "type": "object", + "required": [ + "name", + "valueReference" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "createFrom" + ], + "example": "createFrom" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "CommunicationRequest/000000070000/_history/4" + } + } + } + } + }, + { + "title": "guidance", + "description": "Parameter to supply the guidance", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "guidance" + ], + "example": "guidance" + }, + "valueString": { + "type": "string", + "example": "I have converted this to send the patient to one of our services" + } + } + }, + { + "title": "newReferralPriority", + "description": "Parameter to supply a newReferralPriority", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "newReferralPriority" + ], + "example": "newReferralPriority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "reviewComments", + "description": "Parameter to supply the reviewComments", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "reviewComments" + ], + "example": "reviewComments" + }, + "valueString": { + "type": "string", + "example": "Refer this patient to our 'xxx' service please as soon as possible" + } + } + }, + { + "title": "guidanceAttachmentFile", + "description": "Parameter to supply a guidanceAttachmentFile", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "guidanceAttachmentFile" + ], + "example": "guidanceAttachmentFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "GUIDANCE_RESPONSE" + ], + "example": "GUIDANCE_RESPONSE" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + }, + { + "title": "reviewAttachmentFile", + "description": "Parameter to supply a reviewAttachmentFile", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "reviewAttachmentFile" + ], + "example": "reviewAttachmentFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER" + ], + "example": "PROVIDER" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "no-attachments": { + "summary": "No attachments", + "value": { + "$ref": "../../examples/convertAdviceAndGuidanceToReferral/requests/NoAttachments.json" + } + }, + "with-attachments": { + "summary": "With attachments", + "value": { + "$ref": "../../examples/convertAdviceAndGuidanceToReferral/requests/WithAttachments.json" + } + } + } + } + } + }, + "responses": { + "201": { + "description": "A referral converted from A&G request.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "no-attachments": { + "summary": "No attachments", + "value": { + "$ref": "../../../examples/convertAdviceAndGuidanceToReferral/responses/NoAttachments.json" + } + }, + "with-attachments": { + "summary": "With attachments", + "value": { + "$ref": "../../../examples/convertAdviceAndGuidanceToReferral/responses/WithAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNSUPPORTED_PRIORITY | The Priority submitted is not supported by the responsible Service. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.recordReviewOutcome": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint, as a service provider, to record a triage outcome for the following referrals awaiting review:\n - referrals sent into a triage service\n - referrals deferred into a directly bookable service because of appointment slot unavailability\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Application-restricted, unattended access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nTo access this endpoint in application-restricted, unattended mode, you will be required to submit your use case for review. The only use case currently permitted is for non-clinical provider actions.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. \n[[HYPERLINK_A028]] can only be used for referrals sent into triage services, and not the referrals \nbooked into bookable services.\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Appointment Slot Issues' worklist. \nThis provides a list of referrals that have been deferred into directly bookable services.\n\n - Referrals from this worklist may already have been reviewed or may not have any referral clinical information associated, \n in which case [[HYPERLINK_A028]] cannot be used.\n - [[HYPERLINK_A028]] can only be used for those referrals, on the 'Appointment Slot Issues' worklist, which are pending review.\n - As such, you need to use [[HYPERLINK_A029]] to determine if [[HYPERLINK_A028]] is a permissible action.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\nIf you want to include attachments with the triage outcome, you need to use [[HYPERLINK_A020]] so \nthey are ready to be associated when this endpoint is called.\n\n## Use cases\nAs an authenticated user\n\nI need to return the referral back to the referrer with some advice\n\nSo that I can progress the patient's care appropriately with the referrer.\n\n\nAs an authenticated user\n\nI need to accept the referral and task my admin team to shortlist appropriate services for the patient\n\nSo that I can progress the patient's care along the most appropriate referral pathway.\n\n\n## Important notes\n\n - The only outcomes that are supported by this endpoint are 'Return to referrer with advice' and 'Accept and refer/book later'. 'Refer/book now' is not supported.\n - The triage comment text is mandatory. This comment provided will be sent to:\n - The initial referrer when the 'Return to referrer with advice' triage outcome is chosen.\n - An administrator at the receiving service provider when the 'Accept and refer/book later' outcome is chosen.\n - The priority of the referral can be changed as part of recording the triage outcome\n - When this endpoint is successfully used for recording an outcome of 'Accept and refer/book later', \n an entry will be added to the service providers Appointments For Booking worklist for the admin team to action the task. \n The provider admin team will only be able to progress the referral via the e-RS Professional Application user \n interface (e.g. shortlisting appropriate services for the patient).\n - In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \n The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n - Further details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Record triage outcome (A028, FHIR STU3)", + "operationId": "a028-record-triage-outcome", + "tags": [ + "Review referral requests" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-RecordReviewOutcome-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RecordReviewOutcome-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RecordReviewOutcome-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `reviewOutcome` | `1..1` | |\n| `reviewComments` | `1..1` | |\n| `reviewPriority` | `0..1` | | \n| `reviewAttachmentFile` | `0..*` | | \n", + "items": { + "anyOf": [ + { + "title": "reviewOutcome", + "description": "Parameter to supply a reviewOutcome", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "reviewOutcome" + ], + "example": "reviewOutcome" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "CANCEL_APPOINTMENT_ACTION_LATER", + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "RETURN_TO_REFERRER_WITH_ADVICE" + } + } + } + } + }, + { + "title": "reviewComments", + "description": "Parameter to supply the reviewComments", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "reviewComments" + ], + "example": "reviewComments" + }, + "valueString": { + "type": "string", + "example": "Condition not serious. No further action needed" + } + } + }, + { + "title": "reviewPriority", + "description": "Parameter to supply a reviewPriority", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "reviewPriority" + ], + "example": "reviewPriority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "reviewAttachmentFile", + "description": "Parameter to supply an attachment file", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "reviewAttachmentFile" + ], + "example": "reviewAttachmentFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER" + ], + "example": "PROVIDER" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "return-to-referrer-with-advice": { + "summary": "Return to referrer with advice", + "value": { + "$ref": "../../examples/recordTriageOutcome/requests/ReturnToReferrerWithAdvice.json" + } + }, + "accept-refer-book-later": { + "summary": "Accept refer book later", + "value": { + "$ref": "../../examples/recordTriageOutcome/requests/AcceptReferBookLater.json" + } + }, + "attachment-included": { + "summary": "Attachment included", + "value": { + "$ref": "../../examples/recordTriageOutcome/requests/AttachmentIncluded.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "return-to-referrer-with-advice": { + "summary": "Return to referrer with advice", + "value": { + "$ref": "../../../examples/recordTriageOutcome/responses/ReturnToReferrerWithAdvice.json" + } + }, + "accept-refer-book-later": { + "summary": "Accept refer book later", + "value": { + "$ref": "../../../examples/recordTriageOutcome/responses/AcceptReferBookLater.json" + } + }, + "attachment-included": { + "summary": "Attachment included", + "value": { + "$ref": "../../../examples/recordTriageOutcome/responses/AttachmentIncluded.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PRIORITY_NOT_CURRENT | 'Review Priority' value cannot be amended if Review Outcome value is RETURN_TO_REFERRER_WITH_ADVICE |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/R4/PractitionerRole": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to retrieve a list of available e-RS roles (i.e. business functions) at each organisation where the user works.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nIn order to use this endpoint you must be an authenticated user\n\n## Use case\n\nAs an authenticated user\n\nI need to retrieve a list of authorised e-RS roles for organisations I work for\n\nSo I can choose the appropriate role and organisation to work under when performing tasks.\n\n## Related endpoints\n\nYou can then use the e-RS roles to perform specific tasks using other e-RS endpoints e.g. to satisfy Role and Organisation validation.\n\n### Role and Organisation Validation\n\nThe response from a successful call to [[HYPERLINK_A030]] represents a Practitioner Role Bundle. \nEach Practitioner Role represents an e-RS Role at a specific Organisation. \n\nFor most e-RS endpoints requests are made in the context of a specific authorised e-RS Role at a specific Organisation for the authenticated user. \nThis is accomplished by setting the values of the `NHSD-eRS-Business-Function` and `NHSD-End-User-Organisation-ODS` request headers. \n\nThe e-RS Role is supplied to the endpoint via the `NHSD-eRS-Business-Function` request header. \n\nThe Organisation is supplied to the endpoint via the `NHSD-End-User-Organisation-ODS` request header. \n\nThe `entry` field in the response from [[HYPERLINK_A030]] is an array of PractitionerRole resources. An example of a PractitionerRole resource is: \n```\n\"resource\": {\n \"id\": \"PractitionerRole-R69-000000000101\",\n \"meta\": {\n \"lastUpdated\": \"2021-05-24T16:09:32.252Z\"\n },\n \"resourceType\": \"PractitionerRole\",\n \"practitioner\": {\n \"identifier\": {\n \"system\": \"https://fhir.nhs.uk/Id/sds-user-id\",\n \"value\": \"000000000101\"\n }\n },\n \"organization\": {\n \"identifier\": {\n \"system\": \"https://fhir.nhs.uk/Id/ods-organization-code\",\n \"value\": \"R69\"\n }\n },\n \"code\": [\n {\n \"coding\": [\n {\n \"system\": \"https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1\",\n \"code\": \"SERVICE_DEFINER\"\n }\n ]\n },\n {\n \"coding\": [\n {\n \"system\": \"https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1\",\n \"code\": \"SERVICE_PROVIDER_CLINICIAN\"\n }\n ]\n },\n {\n \"coding\": [\n {\n \"system\": \"https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1\",\n \"code\": \"SERVICE_PROVIDER_ADMIN\"\n }\n ]\n }\n ]\n},\n```\nEach PractitionerRole resource has a `code` field which is an array of codings. \nThe authorised e-RS Roles for the authenticated user at a particular Organisation are represented by the `value` fields in the `https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1` code system. \nThe `NHSD-eRS-Business-Function` request header value should be the `code` field value from the relevant eRS-Business-Function-1 coding in the PractitionerRole resource e.g. `SERVICE_PROVIDER_CLINICIAN`.\n\nEach PractitionerRole resource also has an `organization` field which has an identifier in the `https://fhir.nhs.uk/Id/ods-organization-code` code system.\nThe `NHSD-End-User-Organisation-ODS` request header value should be the `value` field value from the organization identifier in the PractitionerRole resource e.g. \"R69\".\n", + "summary": "Retrieve user business functions (A030, FHIR R4)", + "operationId": "a030-retrieve-business-functions", + "tags": [ + "Retrieve user information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "The response body is a `Bundle` that contains `PractitionerRole` entries which define the [[HYPERLINK_ERS_BUS_FUNCTIONS]] that the user has available at each `Organisation` where they have a role.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "Bundle resource containing practitioner roles", + "description": "The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle \n", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "type", + "total", + "link" + ], + "properties": { + "id": { + "type": "string", + "example": "08acc887-6a7b-4b38-8f50-022e41319efe" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Bundle" + ], + "example": "Bundle" + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "total": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 1 + }, + "link": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/R4/PractitionerRole" + } + } + } + }, + "entry": { + "type": "array", + "items": { + "type": "object", + "required": [ + "fullUrl", + "search", + "resource" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/R4/PractitionerRole/PractitionerRole-R69-000000000101" + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + }, + "resource": { + "type": "object", + "description": "A UKCore-Practitioner Role. The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-PractitionerRole", + "required": [ + "id", + "meta", + "resourceType", + "practitioner", + "organization", + "code" + ], + "properties": { + "id": { + "type": "string", + "example": "PractitionerRole-R69-000000000101" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "PractitionerRole" + ], + "example": "PractitionerRole" + }, + "practitioner": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/sds-user-id" + ], + "example": "https://fhir.nhs.uk/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "organization": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + "code": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + } + } + } + } + } + } + } + } + } + }, + "examples": { + "example-response-body": { + "summary": "Example response body", + "value": { + "$ref": "../../../examples/retrieveBusinessFunctions/responses/PractitionerRoleBundle.json" + } + } + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-supported", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_ACCEPTABLE" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.changeShortlist": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to change the shortlist of bookable and/or triage services on an existing referral.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Important notes\n\nThe maximum amount of services allowed on a given shortlist is 20.\n\nThe act of changing a shortlist alone will not result in a referral being sent/booked to any of the shortlisted services (even if only one service is shortlisted). \nA shortlist of a single triage service should be avoided as this relies on the patient to progress the referral, potentially leading to a delay to care. Especially if the referral priority is 2WW or Urgent.\n\nUse [[HYPERLINK_A016]] if there is a need to support the sending/booking of the referral into a shortlisted service.\n\nA patient can request assistance at a service (e.g. a translator, transport or advocacy) when a shortlist is created within the e-RS web application, meaning that all services shortlisted would support the patient's additional requirements to attend.\n\nThe e-RS APIs do not currently support patients' additional requirements so you can neither specify services that support patients' additional requirements, arrange additional requirements for a patient, or view comments associated with the request for additional requirements.\n\nYou must consider if you are fully meeting the patient's additional requirement needs if there are additional requirements associated with the referral.\n\nIf you do not know whether the patient has an existing additional requirement need and the referral may have been shortlisted within the e-RS web application, be mindful that if you chose to amend the shortlist via changing the services, you could remove this patient need.\n\nIf you are changing services to send the patient to a triage service, the triaging service will not support additional requirements but will need to consider if the patient has any additional requirements as part of their decision for future care.\n\nYou can view additional requirements on a referral via the e-RS web application or by fetching [[HYPERLINK_A005]].\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Use case\nAs an authenticated user\n\nI need to change the shortlist of bookable services and/or triage services on an existing referral\n\nSo that I can adequately manage my patients referral pathway, allowing the patient to book into an appropriate service.\n\n## Related endpoints\nTo allow the patient to book their appointment in their own time, you can generate a letter for the patient by using [[HYPERLINK_A019]]. The letter summarises the current state of the referral and any steps the patient may need to follow (e.g. appointment booking instructions).\n\nYou can book an appointment for the patient into a shortlisted directly bookable service using [[HYPERLINK_A015]] and [[HYPERLINK_A016]].\n\nYou can send the referral into a shortlisted triage service using [[HYPERLINK_A016]].\n\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Change shortlist (A031, FHIR STU3)", + "operationId": "a031-change-shortlist", + "tags": [ + "Manage referral" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ChangeShortlist-Parameters", + "type": "object", + "description": "Parameters provided when looking to change the services a referral has currently shortlisted", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlist-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlist-Parameters-1" + } + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `Shortlist` | `1..1` | Shortlist indicating the new services a referral should have shortlisted |\n| `IntentionToAddReferralLetter` | `1..1` | Flag indicating whether a referral letter is going to be added later or is already added | \n| `FirstReminderLetterFollowUpDays` | `1..1` | Time at which a reminder should be sent to remind the patient about the referral |\n", + "items": { + "anyOf": [ + { + "title": "Shortlist", + "description": "Parameter to supply a shortlist", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "shortlist" + ], + "example": "shortlist" + }, + "resource": { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + } + } + }, + { + "title": "IntentionToAddReferralLetter", + "description": "Parameter to supply the intention to add referral letter flag", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "intentionToAddReferralLetter" + ], + "example": "intentionToAddReferralLetter" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + }, + "code": { + "type": "string", + "enum": [ + "NEED_TO_ADD_LATER", + "NOT_INTENDING_TO_ADD" + ], + "example": "NEED_TO_ADD_LATER" + } + } + } + } + }, + { + "title": "FirstReminderLetterFollowUpDays", + "description": "Parameter to supply the first reminder follow up days", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "firstReminderLetterFollowUpDays" + ], + "example": "firstReminderLetterFollowUpDays" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 0 + } + } + } + ] + } + } + } + }, + "examples": { + "unbookedReferralRequest": { + "summary": "Unbooked ReferralRequest", + "description": "Changing the shortlist of an unbooked `ReferralRequest` (single service shortlist)", + "value": { + "$ref": "../../examples/changeShortlist/requests/UnbookedReferral.json" + } + }, + "unbookedReferralRequestMultipleServices": { + "summary": "Unbooked ReferralRequest with Multiple Services", + "description": "Changing the shortlist of an unbooked `ReferralRequest` (multiple services shortlist)", + "value": { + "$ref": "../../examples/changeShortlist/requests/UnbookedReferralMultipleServices.json" + } + }, + "unbookedReferralRequestMixedShortlist": { + "summary": "Unbooked ReferralRequest with Bookable and Triage Services", + "description": "Changing the shortlist of an unbooked `ReferralRequest` (multiple services shortlist)", + "value": { + "$ref": "../../examples/changeShortlist/requests/UnbookedReferralMixedShortlist.json" + } + }, + "nonMixedShortlistWithDocument": { + "summary": "ReferralRequest with non Mixed service and Document Reference", + "description": "Changing the shortlist of an `ReferralRequest` with document reference.", + "value": { + "$ref": "../../examples/changeShortlist/requests/NonMixedShortlistWithDocument.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Referral updated with new service list", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + }, + "examples": { + "unbookedReferralRequest": { + "summary": "Unbooked ReferralRequest", + "description": "Changing the shortlist of an unbooked `ReferralRequest` (single service shortlist)", + "value": { + "$ref": "../../../examples/changeShortlist/responses/UnbookedReferral.json" + } + }, + "unbookedReferralRequestMultipleServices": { + "summary": "Unbooked ReferralRequest with Multiple Services", + "description": "Changing the shortlist of an unbooked `ReferralRequest` (multiple services shortlist)", + "value": { + "$ref": "../../../examples/changeShortlist/responses/UnbookedReferralMultipleServices.json" + } + }, + "unbookedReferralRequestMixedShortlist": { + "summary": "Unbooked ReferralRequest with Mixed Services", + "description": "Changing the shortlist of an unbooked `ReferralRequest` (bookable and triage service shortlist)", + "value": { + "$ref": "../../../examples/changeShortlist/responses/UnbookedReferralMixedShortlist.json" + } + }, + "nonMixedShortlistWithDocument": { + "summary": "ReferralRequest with non Mixed service and Document Reference", + "description": "Changing the shortlist of an `ReferralRequest` with document reference.", + "value": { + "$ref": "../../../examples/changeShortlist/responses/NonMixedShortlistWithDocument.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostic property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.changeShortlistAndSendForTriage": { + "post": { + "deprecated": true, + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n**This endpoint has now been deprecated please use [[HYPERLINK_A031]] instead.**\n\nUse this endpoint to change the shortlist to a single triage service and refer the patient directly to that triage service.\n\nPlease note: this endpoint cannot be used to shortlist bookable services. In order to shortlist bookable services on an existing referral please use [[HYPERLINK_A031]].\n\nA patient can request assistance at a service (e.g. a translator, transport or advocacy) when a shortlist is created within the e-RS web application, meaning that all services shortlisted would support the patient's additional requirements to attend.\n\nThe e-RS APIs do not currently support patients' additional requirements so you can neither specify services that support patients' additional requirements, arrange additional requirements for a patient, or view comments associated with the request for additional requirements.\n\nYou must consider if you are fully meeting the patient's additional requirement needs if there are additional requirements associated with the referral.\n\nIf you do not know whether the patient has an existing additional requirement need and the referral may have been shortlisted within the e-RS web application, be mindful that if you chose to amend the shortlist via changing the services, you could remove this patient need.\n\nIf you are changing services to send the patient to a triage service, the triaging service will not support additional requirements but will need to consider if the patient has any additional requirements as part of their decision for future care.\n\nYou can view additional requirements on a referral via the e-RS web application or by fetching [[HYPERLINK_A005]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Important Notes\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use case\nAs an authenticated user\n\nI need to change the shortlist and refer the patient to a triage service for assessment\n\nSo that I can put the patient on the appropriate clinical pathway for the chosen service provider.\n\n## Related endpoints\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A006]], and [[HYPERLINK_A007]] endpoints where necessary.\n\nYou can calculate the date when the patient will need to be contacted (by the triage service) using reference data from [[HYPERLINK_A004]].\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Change shortlist and send for triage (A032, FHIR STU3) [deprecated]", + "operationId": "a032-change-shortlist-and-send-for-triage", + "tags": [ + "Manage referral" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ChangeShortlistAndSendForTriage-Request-Parameters", + "type": "object", + "description": "Parameters provided when looking to change the services a referral has currently shortlisted", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Request-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Request-Parameters-1" + } + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `Shortlist` | `1..1` | Shortlist indicating the new service a referral should have shortlisted |\n| `IntentionToAddReferralLetter` | `1..1` | Flag indicating whether a referral letter is going to be added later or is already added | \n| `FirstReminderLetterFollowUpDays` | `1..1` | Time at which a reminder should be sent to remind the patient about the referral |\n", + "items": { + "anyOf": [ + { + "title": "Shortlist", + "description": "Parameter to supply a shortlist. When sending for triage, \nthe shortlist must contain exactly one service, and this must support the 'triage request flow'.\n", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "shortlist" + ], + "example": "shortlist" + }, + "resource": { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + } + } + }, + { + "title": "IntentionToAddReferralLetter", + "description": "Parameter to supply the intention to add referral letter flag", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "intentionToAddReferralLetter" + ], + "example": "intentionToAddReferralLetter" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" + }, + "code": { + "type": "string", + "enum": [ + "NEED_TO_ADD_LATER", + "NOT_INTENDING_TO_ADD" + ], + "example": "NEED_TO_ADD_LATER" + } + } + } + } + }, + { + "title": "FirstReminderLetterFollowUpDays", + "description": "Parameter to supply the first reminder follow up days. When sending for triage, \nthe only acceptable value is 0, which means no follow up letter will be sent, \nas the patient does not need to book an appointment.\n", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "firstReminderLetterFollowUpDays" + ], + "example": "firstReminderLetterFollowUpDays" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 0 + } + } + } + ] + } + } + } + }, + "examples": { + "parameters": { + "summary": "Unbooked ReferralRequest", + "description": "Changing the service list of an unbooked `ReferralRequest` and sending to Triage", + "value": { + "$ref": "../../examples/changeShortlistAndSendForTriage/requests/MinimalRequest.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "Referral updated with new service and sent for Triage", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-ChangeShortlistAndSendForTriage-Response-Parameters", + "type": "object", + "description": "Parameters provided when looking to change the services a referral has currently shortlisted", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Response-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Response-Parameters-1" + } + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `updatedReferralRequest` | `1..1` | |\n| `createdAppointment` | `1..1` | | \n", + "items": { + "anyOf": [ + { + "title": "updatedReferralRequest", + "description": "Parameter containing the updated referral request", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "updatedReferralRequest" + ], + "example": "updatedReferralRequest" + }, + "resource": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + } + } + }, + { + "title": "createdAppointment", + "description": "Parameter containing the newly created appointment", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "createdAppointment" + ], + "example": "createdAppointment" + }, + "resource": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "unbookedReferralRequest": { + "summary": "TriagedReferralRequest", + "description": "Changing the service list of an unbooked `ReferralRequest` and send for Triage", + "value": { + "$ref": "../../../examples/changeShortlistAndSendForTriage/responses/MinimalRequest.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostic property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/R4/HealthcareService/{id}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nA patient may have 0 to 20 services associated with a single referral. A service is a place where a referrer can send a patient or obtain clinical \nadvice concerning a specific patient. Services have attributes that can be used to understand a services functionality, terms of use, and contact \ninformation. \nYou can use this endpoint to obtain the current version and attributes of a single service.\n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified one service ID in order to use this endpoint.\n\n## Use case\nAs an authenticated user\n\nI would like to be able to see current service information\n\nSo that I can trust that the service information is correct for my patient's referral\n\n## Related endpoints\n - You can retrieve service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist containing at least a single service.\n - You can check if a cached service has changed via [[HYPERLINK_A037]].\n - You can retrieve the attributes of an entire shortlist of services (1-20) via [[HYPERLINK_A035]].\n\n## Known Issues\nThe HealthcareService.type attribute is being returned as a singular object by this endpoint. As per the [FHIR standard](https://hl7.org/fhir/R4/), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Service Id |\n| ------------------------------------------------------------------------ | ---------- |\n| `Service` and minimal attributes | `1` |\n| `Service` and its attributes | `2` |\n", + "summary": "Retrieve healthcare service (A033, FHIR R4)", + "operationId": "a033-retrieve-healthcare-service", + "tags": [ + "Retrieve healthcare service information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "name": "id", + "in": "path", + "description": "The ID of the service to be retrieved. It must be valid and relate to an existing Healthcare Service otherwise a HTTP 404 response will be returned.\n", + "required": true, + "schema": { + "type": "string", + "example": "1" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "Response contains the Healthcare Service requested.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Cache-Control": { + "description": "To specify the caching policies in client requests and server responses\n", + "required": false, + "schema": { + "type": "string", + "example": "no-cache" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-HealthcareService", + "description": "A e-referral service. The canonical URL: https://fhir.nhs.uk/StructureDefinition/eRS-HealthcareService", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "location", + "name" + ], + "properties": { + "id": { + "type": "string", + "example": "1" + }, + "meta": { + "type": "object", + "required": [ + "versionId" + ], + "properties": { + "versionId": { + "type": "string", + "example": "1" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "HealthcareService" + ], + "example": "HealthcareService" + }, + "extension": { + "type": "array", + "nullable": false, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| Extension-eRS-HoursOfOperation | 0..1 | Details the hours the current HealthcareService is operational |\n| Extension-eRS-HealthcareService-Contact | 0..* | Details any contact information for the HealthcareService |\n| Extension-eRS-ServiceInstructions | 0..1 | Outlines any specific instructions that should be followed around the HealthcareService |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-HoursOfOperation", + "description": "Extension to detail the hours of operation outlined for a HealthcareService.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" + ], + "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" + }, + "valueString": { + "type": "string", + "example": "9-5 Monday to Friday" + } + } + }, + { + "title": "Extension-eRS-HealthcareService-Contact", + "description": "Extension detailing the contact details for a HealthcareService", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" + ], + "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| purpose | 1..1 | Details who should be using the current contact method |\n| telecom | 1..* | Outlines the contact details to be used |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "purpose", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "purpose" + ], + "example": "purpose" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "enum": [ + "http://terminology.hl7.org/CodeSystem/contactentity-type", + "https://fhir.nhs.uk/CodeSystem/eRS-Purpose" + ], + "example": "http://terminology.hl7.org/CodeSystem/contactentity-type" + }, + "code": { + "type": "string", + "enum": [ + "BILL", + "ADMIN", + "HR", + "PAYOR", + "PATINF", + "PRESS", + "HEALTHCARE_PROFESSIONALS" + ], + "example": "PATINF" + }, + "display": { + "type": "string", + "enum": [ + "Billing", + "Administrative", + "Human Resource", + "Payor", + "Patient", + "Press", + "Healthcare Professionals" + ], + "example": "Patient" + } + } + } + } + } + } + } + }, + { + "type": "object", + "title": "telecom", + "required": [ + "url", + "valueContactPoint" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "telecom" + ], + "example": "telecom" + }, + "valueContactPoint": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "phone", + "email" + ], + "example": "phone" + }, + "value": { + "type": "string", + "example": "01235 209823" + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-ServiceInstructions", + "description": "Extension to detail any service instructions for a HealthcareService.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" + ], + "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" + }, + "valueString": { + "type": "string" + } + } + } + ] + } + }, + "location": { + "type": "array", + "items": { + "type": "object", + "properties": { + "identifier": { + "description": "Reference detailing the location a service is based within.", + "type": "object", + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-site-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-site-code" + }, + "value": { + "type": "string", + "example": "R6901" + } + } + } + } + } + }, + "name": { + "type": "string", + "example": "Direct SVC 1", + "description": "Name of the current HealthcareService within eRS" + }, + "type": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" + }, + "code": { + "type": "string", + "enum": [ + "DAY_CASE", + "FIRST_OUTPATIENT", + "ASSESSMENT_SERVICE", + "GPSI", + "AHP_CLINIC", + "DIAGNOSTIC", + "NURSE_CLINIC", + "OPHTHALMOLOGIST", + "TELEPHONE_ASSESSMENT" + ], + "example": "DAY_CASE" + }, + "display": { + "type": "string", + "enum": [ + "Day Case", + "First Outpatient", + "Assessment Service", + "GPSI", + "AHP Clinic", + "Diagnostic", + "Nurse Clinic", + "Ophthalmologist", + "Telephone Assessment" + ], + "example": "Day Case" + } + } + } + } + } + } + }, + "characteristic": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-RequestFlowType", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" + }, + "code": { + "type": "string", + "enum": [ + "BOOKABLE", + "REVIEW", + "ADVICE_AND_GUIDANCE" + ], + "example": "BOOKABLE" + }, + "display": { + "enum": [ + "A service which supports a patient appointment", + "A service that reviews referrals, without the support or need for any appointment with the patient to be made", + "A service which can discuss the patient and receive guidance rather than a patient attending an appointment" + ], + "example": "A service which supports a patient appointment" + } + } + }, + { + "type": "object", + "title": "eRS-BookableType", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" + }, + "code": { + "type": "string", + "enum": [ + "DIRECTLY_BOOKABLE", + "INDIRECTLY_BOOKABLE" + ], + "example": "DIRECTLY_BOOKABLE" + }, + "display": { + "enum": [ + "Directly Bookable", + "Indirectly Bookable" + ], + "example": "Directly Bookable" + } + } + } + ] + } + } + } + } + } + } + }, + "examples": { + "single-service-minimal": { + "summary": "Service and minimal attributes.", + "value": { + "$ref": "../../../examples/getService/responses/sampleServiceWithMinimumAttributes.json" + } + }, + "single-service": { + "summary": "Service and its attributes.", + "value": { + "$ref": "../../../examples/getService/responses/sampleServiceWithFullAttributes.json" + } + } + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-found", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_FOUND" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-supported", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_ACCEPTABLE" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + }, + "head": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nA Patient may have 0 to 20 services associated with a single referral. \nA service is a place where a referrer can send a patient or obtain clinical advice concerning a specific patient.\n\nYou can use this endpoint to obtain the current service's \"version\" held in e-RS, in order to compare to a locally cached version. \n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified one service ID in order to use this endpoint.\n\n## Use case\nAs an authenticated user\n\nI would like to be able to see the current information about a service on my patients current shortlist\n\nSo that I can review and trust the information is still valid within the context of my patients needs\n\n## Related endpoints\n - You can obtain Service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist containing at least one service.\n - You can retrieve a set of services and their attributes via [[HYPERLINK_A035]].\n - You can fetch the attributes of a single service via [[HYPERLINK_A033]].\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Service Id |\n| ------------------------------------------------------------------------ | ---------- |\n| Get `Service` Version | `1` |\n", + "summary": "Retrieve healthcare service version (A037, FHIR R4)", + "operationId": "a037-retrieve-healthcare-service-version", + "tags": [ + "Retrieve healthcare service information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "name": "id", + "in": "path", + "description": "The ID of the service to be retrieved. It must be valid and relate to an existing Healthcare Service otherwise a HTTP 404 response will be returned.\n", + "required": true, + "schema": { + "type": "string", + "example": "1" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "responses": { + "200": { + "description": "Response doesn't contain the payload. But the current version of the Healthcare Service is in the ETag Response Header.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "cache-control": { + "description": "To specify the caching policies in client requests and server responses\n", + "required": false, + "schema": { + "type": "string", + "example": "no-cache" + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_RELATIONSHIP | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The caller has no legitimate relationship with the resource. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-found", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_FOUND" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Appointment/{id}": { + "put": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to cancel an appointment that is booked into a directly-bookable service. Appointments made to directly-bookable services always have a date and time. You can only ever update the current appointment, i.e. an appointment that is related to a service on the current shortlist *and* the most recent appointment made.\n\nCurrently, this endpoint only allows cancellation of an appointment as an update. Future developments may permit further updates.\n\nTo cancel the referral, use [[HYPERLINK_A036]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n\nYou must use [[HYPERLINK_A004]] to retrieve reference data from the set `APPOINTMENT-CANCELLATION-REASON`.\n\nTo find out which reference data from this set can be used to cancel an appointment, filter as follows:\n\n - *usage* must be `CANCEL`,\n - *businessFunction* must be `REFERRING_CLINICIAN` or `REFERRING_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action),\n - *effectiveFrom* must be in the past, and\n - *effectiveTo* must not be in the past\n\nBoth the appointment reference, and version, are needed to update an appointment:\n\nYou must use [[HYPERLINK_A005]] to obtain the current appointment reference (via *Extension-eRS-Appointment-Reference-1*).\n\nYou must use [[HYPERLINK_A038]] to obtain the current appointment and get the current appointment's version. \n\n## Use case\nAs an authenticated user\n\nI need to update the current appointment\n\nSo that I can manage the patients care appropriately. \n\n## Related endpoints\nYou can retrieve the reference data needed to cancel an appointment by using [[HYPERLINK_A004]]. This contains \"reasons\" for cancellation.\n\nYou can check if you currently can cancel the appointment by checking [[HYPERLINK_A029]].\n\nYou must use [[HYPERLINK_A005]] to obtain the current appointment reference (via *Extension-eRS-Appointment-Reference-1*) .\n\nYou must use [[HYPERLINK_A038]] to obtain the current appointment and get the current appointment's version. \n\nYou can use [[HYPERLINK_A031]] after updating an appointment, to create a new shortlist of services. After changing a shortlist, you may be able to [[HYPERLINK_A016]]. \n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", + "summary": "Update appointment (A034, FHIR STU3)", + "operationId": "a034-update-appointment", + "tags": [ + "Change appointment" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "id", + "in": "path", + "description": "The ID of the appointment to be supplied. It must be valid and relate to an existing Appointment Id otherwise a HTTP 404 response will be returned.\n", + "required": true, + "schema": { + "type": "string", + "example": "70000" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + "examples": { + "minimal-cancellation-reason-only": { + "summary": "Minimal Cancellation - Only Reason Provided (when a cancellation comment is not mandatory)", + "value": { + "$ref": "../../examples/updateAppointment/requests/MinimalCancellationReasonOnlyCommentNotMandatory.json" + } + }, + "cancellation-reason-and-comment": { + "summary": "Reason and Comment Provided", + "value": { + "$ref": "../../examples/updateAppointment/requests/CancellationReasonAndMandatoryComment.json" + } + }, + "cancellation-reason-only-comment-mandatory": { + "summary": "Only Reason Provided (when a cancellation comment is mandatory)", + "value": { + "$ref": "../../examples/updateAppointment/requests/CancellationReasonOnlyCommentMandatory.json" + } + }, + "unauthorised-cancellation-reason": { + "summary": "Unauthorised Cancellation Reason", + "value": { + "$ref": "../../examples/updateAppointment/requests/CancellationInvalidReason.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "An appointment within e-RS.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + "examples": { + "minimal-cancellation-reason-only": { + "summary": "Minimal Cancellation - Only Reason Provided (when a cancellation comment is not mandatory)", + "value": { + "$ref": "../../../examples/updateAppointment/responses/MinimalCancellationReasonOnlyCommentNotMandatory.json" + } + }, + "cancellation-reason-and-comment": { + "summary": "Reason and Comment Provided", + "value": { + "$ref": "../../../examples/updateAppointment/responses/CancellationReasonAndMandatoryComment.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_STATE | A note describing that the Request is not in the correct state should be returned to the caller. |\n| INVALID_VALUE | Reason provided is not a valid Cancellation Reason. |\n| INAPPROPRIATE_VALUE | Reason provided is not a valid in this case. |\n| MISSING_VALUE | Part of early validation that checks that the input conforms with the specifications of the FHIR profiles. A field defined as Mandatory on the FHIR profile is not provided. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| NO_RELATIONSHIP | No legitimate relationship with referral (UBRN). |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| UNABLE_TO_CANCEL_APPOINTMENT | Unable to cancel the appointment. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "examples": { + "cancellation-reason-only-comment-mandatory": { + "summary": "Only Reason Provided (when a cancellation comment is mandatory)", + "value": { + "$ref": "../../../examples/updateAppointment/responses/CancellationReasonOnlyCommentMandatory.json" + } + }, + "unauthorised-cancellation-reason": { + "summary": "Unauthorised Cancellation Reason", + "value": { + "$ref": "../../../examples/updateAppointment/responses/CancellationInvalidReason.json" + } + } + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "502": { + "description": "Where status code 502 (Bad Gateway) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_RESPONDED_WITH_ERROR | Error received from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_RESPONDED_WITH_ERROR", + "display": "Error received from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: ERROR" + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + }, + "504": { + "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "timeout", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_NOT_RESPONDING", + "display": "No response from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" + } + ] + } + } + } + } + } + }, + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to retrieve the current version of an appointment. An appointment is made to a service so a patient can be seen or for the referral to be reviewed, prior to care.\n\nA referral may, or may not, have an appointment and an appointment will always relate to a specific referral.\n\nIt is possible to have more than one appointment during the life of the referral, but never concurrent appointments. This endpoint only returns the current appointment and does not support historic views.\n\nThe outcome of a referral review can be recorded on an appointment. Cancellation or maintenance of an appointment (such as the intent to cancel the current appointment and book another one later) are recorded against the current appointment.\n\ne-RS currently supports a number of appointment scenarios:\n\n - Where a booking has been made to a directly-bookable service (DBS)\n - Where a deferred booking is made when a slot could not be found at a directly-bookable service. In this case, the service \"books\" the appointment\n - Where a booking has been made to a indirectly-bookable service (IBS)\n - Where a review is required by a triage service\n - Where a review has been conducted by a triage service\n - Where a service has rejected, or accepted an appointment\n - Where an appointment has been cancelled, and no further action is possible\n - Where an appointment is currently cancelled, but a future appointment may be made by a service later\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral in order to retrieve details of an appointment that it relates to.\n\nNote: e-RS only supports the retrieval of the most recent version of Appointment. You cannot retrieve earlier versions.\n\n## Use case\n\nAs an authenticated user\n\nI want to read details of an appointment\n\nSo that I can decide what further action may be needed.\n\n## Related endpoints\nNote that in some cases below, an appointment forms part of the referral returned.\n\nYou can always retrieve the current version of an existing appointment via [[HYPERLINK_A005]].\n\nWhen successfully accepting an appointment, the accepted appointment is returned via [[HYPERLINK_A013]].\n\nWhen successfully rejecting an appointment, the rejected appointment is returned via [[HYPERLINK_A014]].\n\nWhen booking an appointment to a directly bookable service, deferring the booking responsibility to a directly bookable service, or referring a patient into a triage service, an \"appointment\" is returned via [[HYPERLINK_A016]].\n\nWhen successfully cancelling an appointment, to action it later, the cancelled appointment is returned via [[HYPERLINK_A022]].\n\nWhen converting an advice and guidance to a referral, if the referral has an appointment, it will be returned via [[HYPERLINK_A027]].\n\nHaving successfully reviewed a referral, details of that review are shown on the appointment returned via [[HYPERLINK_A028]].\n\nYou will need the appointment version when using [[HYPERLINK_A034]], which can be obtained from [[HYPERLINK_A038]].\n\nIf an appointment is cancelled as part of [[HYPERLINK_A036]], an appointment will be returned as part of a successful response.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| --------------------------------------------------------------------------------------------------------- | ----------------------- |\n| `Appointment` booked to directly-bookable service | `appointmentId`=`70000` |\n| `Appointment` booked to indirectly-bookable service | `appointmentId`=`70001` |\n| `Appointment` deferred to service provider for booking | `appointmentId`=`70002` |\n| `Appointment` sent for triage | `appointmentId`=`70003` |\n| `Appointment` triage response (Record Triage Outcome) | `appointmentId`=`70004` |\n| `Appointment` Cancel Appointment, Action Later | `appointmentId`=`70005` |\n| `Appointment` cancelled | `appointmentId`=`70006` |\n| `Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service | `appointmentId`=`70007` |\n", + "summary": "Retrieve appointment (A038, FHIR STU3)", + "operationId": "a038-retrieve-appointment", + "tags": [ + "Change appointment" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "id", + "in": "path", + "description": "The ID of the appointment to be supplied. It must be valid and relate to an existing Appointment Id otherwise a HTTP 404 response will be returned.\n", + "required": true, + "schema": { + "type": "string", + "example": "70000" + } + } + ], + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + "examples": { + "booked-dbs": { + "summary": "`Appointment` booked to directly-bookable service", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/BookedDBS.json" + } + }, + "booked-ibs": { + "summary": "`Appointment` booked to indirectly-bookable service", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/BookedIBS.json" + } + }, + "deferred-to-provider": { + "summary": "`Appointment` deferred to service provider for booking", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/AppointmentDeferral.json" + } + }, + "deferred-to-triage": { + "summary": "`Appointment` sent for triage", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/TriageDeferral.json" + } + }, + "triage-response": { + "summary": "`Appointment` triage response (Record Triage Outcome)", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/TriageResponse.json" + } + }, + "cancel-appointment-action-later": { + "summary": "`Appointment` Cancel Appointment, Action Later", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/CAAL.json" + } + }, + "cancelled": { + "summary": "`Appointment` cancelled", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/Cancelled.json" + } + }, + "converted-and-booked": { + "summary": "`Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/AandGConvertedToDBS.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/Appointment/{id}/_history/{version}": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to retrieve a specific version of an `Appointment`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nThe pre-requisites for this endpoint are the same as for endpoint [[HYPERLINK_A038]].\n\nNote: e-RS only supports the retrieval of the most recent version of an `Appointment`. You cannot retrieve earlier versions.\n\n## Use case\n\nSee [[HYPERLINK_A038]].\n\n## Related endpoints\n\nSee [[HYPERLINK_A038]].\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| --------------------------------------------------------------------------------------------------------- | -------------------------------------- |\n| `Appointment` booked to directly-bookable service | `appointmentId`=`70000`, `version`=`5` |\n| `Appointment` booked to indirectly-bookable service | `appointmentId`=`70001`, `version`=`5` |\n| `Appointment` deferred to service provider for booking | `appointmentId`=`70002`, `version`=`5` |\n| `Appointment` sent for triage | `appointmentId`=`70003`, `version`=`5` |\n| `Appointment` triage response (Record Triage Outcome) | `appointmentId`=`70004`, `version`=`5` |\n| `Appointment` Cancel Appointment, Action Later | `appointmentId`=`70005`, `version`=`5` |\n| `Appointment` cancelled | `appointmentId`=`70006`, `version`=`5` |\n| `Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service | `appointmentId`=`70007`, `version`=`5` |\n", + "summary": "Retrieve appointment (versioned) (A038, FHIR STU3)", + "operationId": "a038-retrieve-appointment-versioned", + "tags": [ + "Change appointment" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "id", + "in": "path", + "description": "The ID of the appointment to be supplied. It must be valid and relate to an existing Appointment Id otherwise a HTTP 404 response will be returned.\n", + "required": true, + "schema": { + "type": "string", + "example": "70000" + } + }, + { + "name": "version", + "in": "path", + "description": "The version of the resource to be retrieved. It must be the latest version of the resource otherwise\n`HISTORY_NOT_SUPPORTED` error will be returned (HTTP 404 Not Found).\n", + "required": true, + "schema": { + "type": "string", + "example": "5" + } + } + ], + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "ETag": { + "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"2\"" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + "examples": { + "booked-dbs": { + "summary": "`Appointment` booked to directly-bookable service", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/BookedDBS.json" + } + }, + "booked-ibs": { + "summary": "`Appointment` booked to indirectly-bookable service", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/BookedIBS.json" + } + }, + "deferred-to-provider": { + "summary": "`Appointment` deferred to service provider for booking", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/AppointmentDeferral.json" + } + }, + "deferred-to-triage": { + "summary": "`Appointment` sent for triage", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/TriageDeferral.json" + } + }, + "triage-response": { + "summary": "`Appointment` triage response (Record Triage Outcome)", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/TriageResponse.json" + } + }, + "cancel-appointment-action-later": { + "summary": "`Appointment` Cancel Appointment, Action Later", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/CAAL.json" + } + }, + "cancelled": { + "summary": "`Appointment` cancelled", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/Cancelled.json" + } + }, + "converted-and-booked": { + "summary": "`Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service", + "value": { + "$ref": "../../../examples/retrieveAppointment/responses/AandGConvertedToDBS.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/R4/HealthcareService": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nA Patient may have 0 to 20 Services associated with a single referral. \nA service is a place where a referrer can send a patient or obtain clinical advice concerning a specific patient. \nYou can use this endpoint to obtain a set of services (up to 20) and their associated attributes, in a single call. \n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified at least one service ID in order to use this endpoint.\n\n## Use case\nAs an authenticated user\n\nI would like to obtain information about all services on my patient's current shortlist\n\nSo that I can review the entire shortlist of services and each service's current attributes\n\n## Related endpoints\n - You can retrieve service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist of at least one service.\n - You can check if a cached service has changed via [[HYPERLINK_A037]].\n - You can fetch the attributes of a single service via [[HYPERLINK_A033]].\n\n## Known Issues\nThe HealthcareService.type attribute is being returned as a singular object by this endpoint. As per the [FHIR standard](https://hl7.org/fhir/R4/), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Service Id |\n| ------------------------------------------------------------------------------------------------------------- | ---------- |\n| Search for multiple service with minimal attributes | `1,2` |\n| Search for multiple service max and min attributes | `3`,`4` |\n| Search for multiple service, where the service IDs are formatted correctly, but none of the service IDs match | `5`,`6` |\n", + "summary": "Search for healthcare services (A035, FHIR R4)", + "operationId": "a035-search-for-healthcare-services", + "tags": [ + "Retrieve healthcare service information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "query", + "name": "_id", + "description": "One or many service ID(s) to include as part of the search. Must be supplied, otherwise a 400 response will be returned.\n", + "required": true, + "schema": { + "type": "string", + "example": "1,2" + } + } + ], + "responses": { + "200": { + "description": "Bundle resource containing the `eRS-HealthcareService` resources associated to the supplied search criteria. \nThe canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle \n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "Bundle resource containg healthcare services", + "type": "object", + "required": [ + "id", + "meta", + "type", + "timestamp", + "total", + "link" + ], + "properties": { + "id": { + "type": "string", + "example": "123e4567-e89b-12d3-a456-426614174000" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "timestamp": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.00Z" + }, + "total": { + "description": "The total number of HeatlhcareServices that matched the supplied search critera", + "type": "integer", + "example": 1 + }, + "link": { + "type": "array", + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/R4/HealthcareService?_id=1,2" + } + } + } + }, + "entry": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `HealthcareService` | `0..*` | | \n", + "items": { + "title": "HealthcareService", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/R4/HealthcareService/1" + }, + "resource": { + "title": "eRS-HealthcareService", + "description": "A e-referral service. The canonical URL: https://fhir.nhs.uk/StructureDefinition/eRS-HealthcareService", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "location", + "name" + ], + "properties": { + "id": { + "type": "string", + "example": "1" + }, + "meta": { + "type": "object", + "required": [ + "versionId" + ], + "properties": { + "versionId": { + "type": "string", + "example": "1" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "HealthcareService" + ], + "example": "HealthcareService" + }, + "extension": { + "type": "array", + "nullable": false, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| Extension-eRS-HoursOfOperation | 0..1 | Details the hours the current HealthcareService is operational |\n| Extension-eRS-HealthcareService-Contact | 0..* | Details any contact information for the HealthcareService |\n| Extension-eRS-ServiceInstructions | 0..1 | Outlines any specific instructions that should be followed around the HealthcareService |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-HoursOfOperation", + "description": "Extension to detail the hours of operation outlined for a HealthcareService.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" + ], + "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" + }, + "valueString": { + "type": "string", + "example": "9-5 Monday to Friday" + } + } + }, + { + "title": "Extension-eRS-HealthcareService-Contact", + "description": "Extension detailing the contact details for a HealthcareService", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" + ], + "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" + }, + "extension": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| purpose | 1..1 | Details who should be using the current contact method |\n| telecom | 1..* | Outlines the contact details to be used |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "purpose", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "purpose" + ], + "example": "purpose" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "enum": [ + "http://terminology.hl7.org/CodeSystem/contactentity-type", + "https://fhir.nhs.uk/CodeSystem/eRS-Purpose" + ], + "example": "http://terminology.hl7.org/CodeSystem/contactentity-type" + }, + "code": { + "type": "string", + "enum": [ + "BILL", + "ADMIN", + "HR", + "PAYOR", + "PATINF", + "PRESS", + "HEALTHCARE_PROFESSIONALS" + ], + "example": "PATINF" + }, + "display": { + "type": "string", + "enum": [ + "Billing", + "Administrative", + "Human Resource", + "Payor", + "Patient", + "Press", + "Healthcare Professionals" + ], + "example": "Patient" + } + } + } + } + } + } + } + }, + { + "type": "object", + "title": "telecom", + "required": [ + "url", + "valueContactPoint" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "telecom" + ], + "example": "telecom" + }, + "valueContactPoint": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "phone", + "email" + ], + "example": "phone" + }, + "value": { + "type": "string", + "example": "01235 209823" + } + } + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-ServiceInstructions", + "description": "Extension to detail any service instructions for a HealthcareService.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" + ], + "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" + }, + "valueString": { + "type": "string" + } + } + } + ] + } + }, + "location": { + "type": "array", + "items": { + "type": "object", + "properties": { + "identifier": { + "description": "Reference detailing the location a service is based within.", + "type": "object", + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-site-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-site-code" + }, + "value": { + "type": "string", + "example": "R6901" + } + } + } + } + } + }, + "name": { + "type": "string", + "example": "Direct SVC 1", + "description": "Name of the current HealthcareService within eRS" + }, + "type": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" + }, + "code": { + "type": "string", + "enum": [ + "DAY_CASE", + "FIRST_OUTPATIENT", + "ASSESSMENT_SERVICE", + "GPSI", + "AHP_CLINIC", + "DIAGNOSTIC", + "NURSE_CLINIC", + "OPHTHALMOLOGIST", + "TELEPHONE_ASSESSMENT" + ], + "example": "DAY_CASE" + }, + "display": { + "type": "string", + "enum": [ + "Day Case", + "First Outpatient", + "Assessment Service", + "GPSI", + "AHP Clinic", + "Diagnostic", + "Nurse Clinic", + "Ophthalmologist", + "Telephone Assessment" + ], + "example": "Day Case" + } + } + } + } + } + } + }, + "characteristic": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-RequestFlowType", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" + }, + "code": { + "type": "string", + "enum": [ + "BOOKABLE", + "REVIEW", + "ADVICE_AND_GUIDANCE" + ], + "example": "BOOKABLE" + }, + "display": { + "enum": [ + "A service which supports a patient appointment", + "A service that reviews referrals, without the support or need for any appointment with the patient to be made", + "A service which can discuss the patient and receive guidance rather than a patient attending an appointment" + ], + "example": "A service which supports a patient appointment" + } + } + }, + { + "type": "object", + "title": "eRS-BookableType", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" + ], + "example": "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" + }, + "code": { + "type": "string", + "enum": [ + "DIRECTLY_BOOKABLE", + "INDIRECTLY_BOOKABLE" + ], + "example": "DIRECTLY_BOOKABLE" + }, + "display": { + "enum": [ + "Directly Bookable", + "Indirectly Bookable" + ], + "example": "Directly Bookable" + } + } + } + ] + } + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + } + } + } + } + } + }, + "examples": { + "multiple-services-minimal": { + "summary": "Search for multiple service with minimal attributes.", + "value": { + "$ref": "../../../examples/searchForServices/responses/searchServiceWithMinmumalAttributes.json" + } + }, + "multiple-services-max-min": { + "summary": "Search for multiple service max and min attributes.", + "value": { + "$ref": "../../../examples/searchForServices/responses/searchServiceWithMaxAndMinAttributes.json" + } + }, + "multiple-services-empty": { + "summary": "Search for multiple service, where the service IDs are formatted correctly, but none of the service IDs match", + "value": { + "$ref": "../../../examples/searchForServices/responses/searchServiceWithEmptyResponse.json" + } + } + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------|\n| REC_BAD_REQUEST | invalid | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | Incorrect or missing expected value. For example; Service Id is invalid or missing, or an an attempt to request more than 20 Service Ids |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_BAD_REQUEST" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_RELATIONSHIP | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The caller has no legitimate relationship with the resource. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-found", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_FOUND" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-supported", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_ACCEPTABLE" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/ReferralRequest/{ubrn}/$ers.cancelReferral": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\nUse this endpoint to cancel a referral and the current appointment, if there is one. Cancelling a referral is a one-way process and results in an end-state. No further progression of care can occur once this action has been performed.\n\nA reason for cancelling an appointment must be provided. A comment on the cancellation is conditionally mandatory depending on the reason selected. See pre-requisites and related referrals for more information.\n\nYou can check if you can cancel a referral by calling [[HYPERLINK_A029]].\n\ne-RS does not allow a referral to be cancelled, without also cancelling the current appointment. Therefore, if there is a current appointment associated with the referral, this *must* be cancelled in advance, or at the same time.\n\nIn order to cancel (only) an appointment you must use [[HYPERLINK_A034]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Application-restricted, unattended access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nTo access this endpoint in application-restricted, unattended mode, you will be required to submit your use case for review. The only use case currently permitted is for non-clinical provider actions.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n- `SERVICE_PROVIDER_CLINICIAN`\n- `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou must use [[HYPERLINK_A004]] to retrieve a list of reference data, which detail the reason the cancellation is being performed. You can only use reference data from the set `REFERRAL-CANCELLATION-REASON`.\n\n\nTo find out which reference data from this set can be used, the following filters can be used depending on the cancellation scenario:\n\n***1. I want to cancel the referral and the current appointment as a Referrer***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `REFERRING_CLINICIAN` or `REFERRING_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `canCancelAppointment` must be true, and\n\n * `effectiveFrom` must be in the past, and \n\n * if provided, `effectiveTo` must **not** be in the past\n\n\n***2. I want to cancel a referral, for which there is no current appointment as a Referrer***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `REFERRING_CLINICIAN` or `REFERRING_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `canCancelAppointment` could be true or false, and\n\n * `effectiveFrom` must be in the past, and\n\n * if provided, `effectiveTo` must **not** be in the past\n\n***3. I want to cancel the referral and the current appointment as a Service Provider***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `SERVICE_PROVIDER_CLINICIAN` or `SERVICE_PROVIDER_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `appointmentRequestCancellationReasonType` must be `PROVIDER` and `PATIENT`, and\n\n * `canCancelAppointment` must be true, and\n\n * `effectiveFrom` must be in the past, and \n\n * `effectiveTo` must **not** be in the past\n\n***4. I want to cancel a referral, for which there is no current appointment as a Service Provider***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `SERVICE_PROVIDER_CLINICIAN` or `SERVICE_PROVIDER_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `appointmentRequestCancellationReasonType` must be `PROVIDER` and `PATIENT`, and\n\n * `canCancelAppointment` could be true or false, and\n\n * `effectiveFrom` must be in the past, and \n\n * `effectiveTo` must **not** be in the past\n\n***5. I want to cancel the triage referral as a Service Provider***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `SERVICE_PROVIDER_CLINICIAN` or `SERVICE_PROVIDER_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `appointmentRequestCancellationReasonType` must be `PROVIDER_TRIAGE`, and\n\n * `effectiveFrom` must be in the past, and \n\n * `effectiveTo` must **not** be in the past\n\nYou need to use [[HYPERLINK_A005]] to retrieve details of the referral in order to make this clinical decision.\n\n## Important note when retrieving attachments\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications. \n\n## Important notes when providing an appointment request cancellation reason\n\nWhen cancelling a referral as a Service Provider Clinician:\n\n * If the referral is in the **\"Triaged - Provider to action\"** state, the cancellation reason must be an **Appointment Request End Triage Reason** type.\n\n * If the referral is **not** in that state, the cancellation reason must be a **Provider Appointment Request Cancellation Reason** or **Patient Appointment Request Cancellation Reason** type.\n\n## Use case\nAs an authenticated user\n\nI need to cancel a referral, and any active appointments\n\nSo that the referral is no longer processed\n\n## Related endpoints\nYou can retrieve the reference data needed to cancel a referral by using [[HYPERLINK_A004]]. This contains \"reasons\" for cancellation.\n\nYou can check if you can cancel the referral by checking [[HYPERLINK_A029]].\n\nYou can use [[HYPERLINK_A005]] to obtain a current appointment reference, if there is one. This endpoint will also provide you with the current UBRN version.\n\nYou can use [[HYPERLINK_A038]] to view the current appointment (where applicable).\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment:\n\n| Scenario | Request details |\n| ------------------------------------------------------------------------ | ------------------------------------- |\n| Reason for Cancellation without Comment (Comment Not Mandatory) | Intend Private With No Comment |\n| Reason for Cancellation with Comment (Comment Mandatory) | Patient Cancellation With Comment |\n| Cancelled Referral | Raised in Error |\n| Cancelled Appointment and Referral | Referrer Cancellation |\n| Cancelled Referral After Prior Appointment Cancellation | Treatment No Longer Required |\n| Cancelled Referral with Existing Review Outcome | Intend Private With Comment |\n| Cancelled Referral (Provider) without Comment (Comment Not Mandatory) | Provider Cancellation With No Comment |\n| Cancelled Referral with Triage Response | Provider Cancellation via End Triage |\n", + "summary": "Cancel referral (A036, FHIR STU3)", + "operationId": "a036-cancel-referral", + "tags": [ + "Manage referral" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the referral request\n", + "required": true, + "schema": { + "type": "string", + "example": "000000070000" + } + }, + { + "in": "header", + "name": "If-Match", + "description": "The version of the resource to be updated\n", + "required": true, + "schema": { + "type": "string", + "pattern": "^W/\"[0-9]+\"$", + "example": "W/\"4\"" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CancelReferral-Request-Parameters", + "type": "object", + "description": "Parameters containing the cancellation reason and comment for referral cancellation request.", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Request-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Request-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `cancellationReason` | `1..1` | The reason why the referral is being cancelled |\n| `cancellationComments` | `0..1` | This may be mandatory if mandatory comment indicator is set to 'Yes' for the Cancellation Reason Type selected. Maximum 2000 characters. |\n", + "items": { + "anyOf": [ + { + "title": "cancellationReason", + "description": "Parameter to supply a cancellationReason", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "cancellationReason" + ], + "example": "cancellationReason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "INTEND_PRIVATE" + } + } + } + } + }, + { + "title": "cancellationComments", + "description": "Parameter to supply the cancellationComments", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "cancellationComments" + ], + "example": "cancellationComments" + }, + "valueString": { + "type": "string", + "example": "Patient will go to a private clinic" + } + } + } + ] + } + } + } + }, + "examples": { + "cancel-referral-without-comment": { + "summary": "Reason for Cancellation without Comment (Comment Not Mandatory)", + "value": { + "$ref": "../../examples/cancelReferral/requests/IntendPrivateWithoutComment.json" + } + }, + "cancel-referral-patient-cancellation": { + "summary": "Reason for Cancellation with Comment (Comment Mandatory)", + "value": { + "$ref": "../../examples/cancelReferral/requests/PatientRequestCancellationOther.json" + } + }, + "cancel-referral-raised-in-error": { + "summary": "Cancelled Referral", + "value": { + "$ref": "../../examples/cancelReferral/requests/RaisedInError.json" + } + }, + "cancel-referral-referrer-cancellation": { + "summary": "Cancelled Appointment and Referral", + "value": { + "$ref": "../../examples/cancelReferral/requests/ReferrerCancellation.json" + } + }, + "cancel-referral-no-longer-required": { + "summary": "Cancelled Referral After Prior Appointment Cancellation", + "value": { + "$ref": "../../examples/cancelReferral/requests/NoLongerRequired.json" + } + }, + "cancel-referral-with-reason-and-comment": { + "summary": "Cancelled Referral with Existing Review Outcome", + "value": { + "$ref": "../../examples/cancelReferral/requests/IntendPrivateWithComment.json" + } + }, + "cancel-referral-provider-without-comment": { + "summary": "Cancelled Referral (Provider) without Comment (Comment Not Mandatory)", + "value": { + "$ref": "../../examples/cancelReferral/requests/bookedOutsideCabWithoutComment.json" + } + }, + "cancel-referral-with-triage-response": { + "summary": "Cancelled Referral with Triage Response", + "value": { + "$ref": "../../examples/cancelReferral/requests/outpatientService.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "e-RS Referral Request", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CancelReferral-Response-Parameters", + "type": "object", + "description": "Parameters containing for the cancelled referral with/without cancelled appointment.", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Response-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Response-Parameters-1" + } + } + } + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `updatedReferralRequest` | `1..1` | Cancelled Referral Request . |\n| `updatedAppointment` | `0..1` | The cancelled appointment resource is only returned if appointment was cancelled part of this cancel referral operation.|\n", + "items": { + "anyOf": [ + { + "title": "updatedReferralRequest", + "description": "Parameter containing the cancelled referral request", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "updatedReferralRequest" + ], + "example": "updatedReferralRequest" + }, + "resource": { + "title": "eRS-ReferralRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "subject", + "supportingInfo", + "intent", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ReferralRequest" + ], + "example": "ReferralRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-Commissioning-Rule-Org", + "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", + "type": "object", + "required": [ + "url", + "valueIdentifier" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralState", + "description": "Extension to outline the current state of a ReferralRequest within e-RS.", + "type": "object", + "required": [ + "url", + "extension" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" + }, + "extension": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", + "items": { + "anyOf": [ + { + "title": "Extension - Referral State", + "description": "Extension to provide the Referral State.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "state" + ], + "example": "state" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" + }, + "code": { + "type": "string", + "enum": [ + "REJECTED", + "CANCELLED_REFERRAL", + "DID_NOT_ATTEND", + "ASSESSMENT_RESULT", + "TRIAGE_RESPONSE", + "APPT_CANCELLED_BY_PROVIDER", + "APPT_CANCELLED_BY_PATIENT", + "AWAITING_TRIAGE", + "NOT_BOOKED", + "DEFERRED_TO_PROVIDER", + "BOOKED", + "TRIAGED_PROVIDER_TO_ACTION" + ], + "example": "APPT_CANCELLED_BY_PATIENT" + }, + "display": { + "type": "string", + "enum": [ + "Rejected", + "Cancelled Referral", + "Did Not Attend", + "Assessment Result", + "Triage Response", + "Appointment Cancelled By Provider", + "Appointment Cancelled By Patient", + "Awaiting Triage", + "Not Booked", + "Deferred To Provider", + "Booked", + "Triaged - Provider To Action" + ], + "example": "Appointment Cancelled By Patient" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason", + "description": "Extension to provide the Referral State Reason.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "reason" + ], + "example": "reason" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" + }, + "code": { + "type": "string", + "example": "PATIENT_ILL" + }, + "display": { + "type": "string", + "example": "Patient Ill" + } + } + } + } + }, + { + "title": "Extension - Referral State Reason Comment", + "description": "Extension to provide the Referral State Reason Comment.", + "type": "object", + "required": [ + "url", + "valueString" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "comments" + ], + "example": "comments" + }, + "valueString": { + "type": "string", + "example": "Patient could not attend appointment due to them being ill." + } + } + } + ] + } + } + } + }, + { + "title": "Extension-eRS-Appointment", + "description": "Extension to supply the appointment for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#appointment" + } + } + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoFirstSubmitted", + "description": "Date and time the clinical information was first submitted", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-ClinicalInfoLastUpdated", + "description": "Date and time the clinical information was last updated", + "type": "object", + "required": [ + "url", + "valueDateTime" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + { + "title": "Extension-eRS-Appointment-Reference", + "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Appointment/70000" + } + } + } + } + }, + { + "title": "Extension-eRS-AdditionalRequirement", + "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVOCACY", + "INTERPRETER", + "TRANSPORT" + ], + "example": "ADVOCACY" + }, + "display": { + "type": "string", + "enum": [ + "Advocacy", + "Interpreter", + "Transport" + ], + "example": "Advocacy" + } + } + } + } + }, + { + "title": "Extension-eRS-eReferralPathwayStart", + "description": "Date and time of the pathway start", + "type": "object", + "required": [ + "url", + "valueInstant" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" + }, + "valueDateTime": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "specialty": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "maxItems": 1, + "minItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "supportingInfo": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70000" + } + } + } + }, + "intent": { + "type": "string", + "enum": [ + "plan" + ], + "example": "plan" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + } + } + }, + { + "title": "updatedAppointment", + "description": "Parameter containing the cancelled appointment", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "updatedAppointment" + ], + "example": "updatedAppointment" + }, + "resource": { + "title": "eRS-Appointment", + "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "description", + "incomingReferral", + "participant" + ], + "properties": { + "id": { + "type": "string", + "example": "'appointment'\n'70001'\n" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" + } + }, + "versionId": { + "type": "string", + "nullable": true, + "example": "3" + } + } + }, + "language": { + "type": "string", + "example": "en" + }, + "resourceType": { + "type": "string", + "enum": [ + "Appointment" + ], + "example": "Appointment" + }, + "status": { + "type": "string", + "enum": [ + "proposed", + "pending", + "booked", + "arrived", + "fulfilled", + "cancelled", + "noshow" + ], + "example": "proposed" + }, + "reason": { + "nullable": true, + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "title": "eRS-ReviewReason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" + }, + "code": { + "type": "string", + "enum": [ + "NO_SLOTS_AT_SERVICE", + "SLOT_NOT_AVAILABLE", + "BOOKING_ATTEMPT_PROBLEM", + "TRIAGE" + ], + "example": "NO_SLOTS_AT_SERVICE" + } + } + }, + { + "type": "object", + "title": "eRS-ReviewOutcome", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", + "CANCEL_APPOINTMENT_ACTION_LATER", + "RETURN_TO_REFERRER_WITH_ADVICE", + "ACCEPT_REFER_BOOK_LATER" + ], + "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Provider Converted Advice and Guidance, Admin to Refer" + } + } + }, + { + "type": "object", + "title": "eRS-Cancellation-Reason", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" + }, + "code": { + "type": "string", + "example": "PATIENT_HOLIDAY" + }, + "display": { + "type": "string", + "nullable": true, + "example": "Patient on holiday" + } + } + } + ] + } + } + } + } + }, + "description": { + "type": "string", + "enum": [ + "e-Referral Appointment" + ], + "example": "e-Referral Appointment" + }, + "start": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T08:30:00.000Z" + }, + "end": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "slot": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "Slot/11002001" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "created": { + "type": "string", + "nullable": true, + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "comment": { + "type": "string", + "nullable": true + }, + "incomingReferral": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "ReferralRequest/000000070000/_history/14" + } + } + }, + "minItems": 0, + "maxItems": 1 + }, + "participant": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", + "items": { + "anyOf": [ + { + "type": "object", + "title": "Patient", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "Service", + "properties": { + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "nullable": true, + "example": "Cardiology Triage Business Service" + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + }, + { + "type": "object", + "title": "AllocatedClinician", + "required": [ + "type", + "actor", + "status" + ], + "properties": { + "type": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://hl7.org/fhir/ValueSet/encounter-participant-type" + ], + "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" + }, + "code": { + "type": "string", + "enum": [ + "CON" + ], + "example": "CON" + } + } + } + } + } + }, + "actor": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "accepted" + ], + "example": "accepted" + } + } + } + ] + }, + "minItems": 2, + "maxItems": 3 + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "cancelled-referral-intend-private-without-comment": { + "summary": "Cancelled Referral without Booking with Reason 'Patient will go to a private clinic' without Comment (Comment Not Mandatory)", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralIntendPrivateWithoutComment.json" + } + }, + "cancelled-referral-patient-other-reason": { + "summary": "Cancelled Referral without Booking with Reason 'Other' with Comment (Comment Mandatory)", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralPatientOther.json" + } + }, + "cancelled-referral-raised-in-error": { + "summary": "Cancelled Referral without Booking with Reason 'Referral created by mistake'", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralRaisedInError.json" + } + }, + "cancelled-referral-with-booking-referrer-cancellation": { + "summary": "Cancelled Referral with Booking with Reason 'Other - Referrer request cancellation'", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledBookedReferralReferrerCancellation.json" + } + }, + "cancelled-referral-with-cancelled-booking-no-longer-required": { + "summary": "Cancelled Referral with Cancelled Booking with Reason 'Referral no longer needed'", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralWithCancelledBookingNoLongerRequired.json" + } + }, + "cancelled-referral-with-deferral-intend-private-with-comment": { + "summary": "Cancelled Referral with Existing Review Outcome with Reason 'Patient will go to a private clinic'", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralResolvedDeferralIntendPrivateWithComment.json" + } + }, + "cancelled-referral-provider-booked-outside": { + "summary": "Cancelled Referral without Booking with Reason 'Patient booked outside NHS e-Referral Service' without Comment (Comment Not Mandatory)'", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralBookedOutsideCabWithoutComment.json" + } + }, + "cancelled-referral-provider-triaged-and-sent-to-outpatient-service": { + "summary": "Cancelled Referral with Triage Response with Reason 'Sent to outpatient service not available in this system' with Comment (Comment Mandatory)'", + "value": { + "$ref": "../../../examples/cancelReferral/responses/CancelledReferralOutpatientService.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "409": { + "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" + }, + "412": { + "description": "Precondition Failed - Mandatory data is missing" + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNABLE_TO_CANCEL_APPOINTMENT | System is unable to cancel the appointment. |\n| INAPPROPRIATE_VALUE\t | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "423": { + "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "502": { + "description": "Where status code 502 (Bad Gateway) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_RESPONDED_WITH_ERROR | Error received from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_RESPONDED_WITH_ERROR", + "display": "Error received from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: ERROR" + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + }, + "504": { + "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "timeout", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "PAS_NOT_RESPONDING", + "display": "No response from PAS" + } + ] + }, + "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" + } + ] + } + } + } + } + } + } + }, + "/R4/Practitioner": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to determine which e-RS users a `SERVICE_PROVIDER_CLINICIAN_ADMIN` is allowed to work \"on-behalf-of\".\n\nNote: In e-RS, `SERVICE_PROVIDER_CLINICIAN_ADMIN` users always act \"on-behalf-of\" a `SERVICE_PROVIDER_CLINICIAN`. This endpoint specifically helps `SERVICE_PROVIDER_CLINICIAN_ADMIN` identify who they are allowed to log in as.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nTo use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles depending on the query being invoked:\n\n| Query | e-RS Role(s) |\n| -------------------------------------------------------------------- | --------------------------------- |\n| onBehalfOf | `SERVICE_PROVIDER_CLINICIAN_ADMIN` |\n\n## Use case\n\nAs an authenticated user who has the `SERVICE_PROVIDER_CLINICIAN_ADMIN` role\n\nI need to know which provider clinical users I am allowed to work \"on-behalf-of\" at my provider organisation\n\nSo I can log in as a `SERVICE_PROVIDER_CLINICIAN_ADMIN` user and complete tasks on behalf of a chosen `SERVICE_PROVIDER_CLINICIAN` user.\n\n## Related endpoints\n\nTo perform actions as a `SERVICE_PROVIDER_CLINICIAN_ADMIN` user, you must provide one of the returned Practitioner IDs, in the `NHSD-eRS-On-Behalf-Of-User-ID` header parameter, to indicate which `SERVICE_PROVIDER_CLINICIAN` the call is on-behalf-of.\n", + "summary": "Retrieve \"on-behalf-of\" practitioner user information (A040, FHIR R4)", + "operationId": "a040-retrieve-practitioner-info", + "tags": [ + "Retrieve user information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "query", + "name": "_query", + "description": "A mandatory URL parameter where \"onBehalfOf\" is the name of the query operation.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "onBehalfOf" + ], + "example": "onBehalfOf" + } + } + ], + "responses": { + "200": { + "description": "The response body is a `Bundle` that contains `Practitioner` entries which define the [[HYPERLINK_ERS_BUS_FUNCTIONS]] that the user has available at each `Organisation` where they have a role.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "Bundle resource containing On-Behalf-Of practitioners", + "description": "The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle \n", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "type", + "total", + "timestamp", + "link" + ], + "properties": { + "id": { + "type": "string", + "example": "08acc887-6a7b-4b38-8f50-022e41319efe" + }, + "resourceType": { + "type": "string", + "enum": [ + "Bundle" + ], + "example": "Bundle" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "total": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 1 + }, + "timestamp": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "link": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/R4/Practitioner?_query=onBehalfOf" + } + } + } + }, + "entry": { + "type": "array", + "items": { + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "Practitioner/111111111111" + }, + "resource": { + "type": "object", + "description": "A UKCore-Practitioner. The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner", + "required": [ + "id", + "meta", + "resourceType", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "111111111111" + }, + "resourceType": { + "type": "string", + "enum": [ + "Practitioner" + ], + "example": "Practitioner" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + } + } + }, + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/sds-user-id" + ], + "example": "https://fhir.nhs.uk/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "111111111111" + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + } + } + } + } + } + }, + "examples": { + "example-response-body": { + "summary": "Example response body", + "value": { + "$ref": "../../../examples/retrieveOboUsers/responses/PractitionerBundle.json" + } + } + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------|\n| REC_BAD_REQUEST | invalid | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The query parameter _query is missing or has an invalid value. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_BAD_REQUEST" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-supported", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_ACCEPTABLE" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/CommunicationRequest/{ubrn}/$ers.generateCRI": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to generate a PDF file that summarises an advice and guidance request including the conversation. \nThis endpoint cannot be used to obtain a PDF file for a referral request.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of an advice and guidance request.\n\n## Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n## Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Important note\n\nAn advice and guidance request may have been converted to a referral (with the same UBRN), \nand in addition a referral pathway in e-RS can be made up of more than one UBRN. \nAs such, it is important that all clinical information is obtained across all the related UBRNs in the pathway. \nThese can be identified using [[HYPERLINK_A005]].\n\nIf the converted advice and guidance request is referred to a service outside of your organisation, \nthe subsequent referral information may not be accessible due to legitimate relationship rules. \nHowever, the advice and guidance summary ([[HYPERLINK_A024]]), \nattachments ([[HYPERLINK_A006]]), advice and guidance conversation ([[HYPERLINK_A025]]) and \nclinical information ([[HYPERLINK_A043]]) which took place before such a conversion still forms part of the clinical information and can still be retrieved.\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve a PDF file overview of the advice and guidance request\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\nYou can retrieve a PDF overview for an advice and guidance request that has been converted to a referral using [[HYPERLINK_A007]].\n\nYou can retrieve structured information about advice and guidance using [[HYPERLINK_A024]] and [[HYPERLINK_A025]].\n\nYou can retrieve a referral using [[HYPERLINK_A005]].\n\nYou can retrieve clinical attachments that are associated with a referral using [[HYPERLINK_A006]].\n", + "summary": "Retrieve advice and guidance overview PDF (A043, FHIR STU3)", + "operationId": "a043-retrieve-advice-and-guidance-overview-pdf", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "name": "ubrn", + "in": "path", + "description": "The unique booking reference number of the advice and guidance request\n", + "required": true, + "schema": { + "type": "string", + "example": "000049146177" + } + } + ], + "responses": { + "200": { + "description": "Response contains the binary stream of the advice and guidance overview PDF.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Disposition": { + "description": "The description of the type of content provided.\n", + "required": true, + "schema": { + "type": "string", + "example": "attachment; filename=\"000049146177_Advice_And_Guidance_20220610143044.pdf\"" + } + }, + "Content-Length": { + "description": "The length of the response.\n", + "required": true, + "schema": { + "type": "string", + "example": "3111" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/pdf" + ], + "example": "application/pdf" + } + } + }, + "content": { + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "404": { + "description": "Not Found" + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an advice and guidance request. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the advice and guidance request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/STU3/CommunicationRequest/$ers.createAdviceAndGuidance": { + "post": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\nUse this endpoint to create an advice and guidance request from a referring organisation to a service providing organisation.\n\nAn advice and guidance request includes important contextual information. For example, the service and specialty to which advice has been requested. Creating the request also starts the conversation between a referrer seeking advice and a provider from whom the advice is sought.\n\nConversation messages can include attachments.\n\n## Supported security patterns\n\nHealthcare worker, user-restricted access\n\n## Important notes\n\nThe maximum number of services allowed on a given shortlist is 1.\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A024]], [[HYPERLINK_A025]] and [[HYPERLINK_A042]] specifications.\n\n## Pre-requisites\nTo use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a patient, for example via [[HYPERLINK_PDS]].\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\nIf you want to include attachments with the request, you need to use [[HYPERLINK_A020]] so they are ready to be associated with the request.\n\n## Use case\n\nAs an authenticated user \n\nI need to request some advice from a given service\n\nSo I can either initiate my patient's referral pathway or provide recommended treatment.\n\n## Related endpoints\n\nProviders are able to respond to an advice and guidance request via [[HYPERLINK_A026]] or convert the advice and guidance request into a referral via [[HYPERLINK_A027]].\n\nReferrers and providers can use:\n\n[[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request\n\n[[HYPERLINK_A025]] to retrieve the advice and guidance conversation.\n", + "summary": "Create advice and guidance request (A044, FHIR STU3)", + "operationId": "a044-create-advice-and-guidance-request", + "tags": [ + "Request advice" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "REFERRING_CLINICIAN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + } + ], + "requestBody": { + "required": true, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CreateAdviceAndGuidance-Request-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Request-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Request-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient the Advice request relates to. |\n| `providerConversionAuthorisation` | `1..1` | A flag detailing whether or not the provider who deals with this advice request is authorised to convert this Advice Request into a Referral |\n| `shortlist` | `1..1` | A list of services where the Advice Request should be sent to. Note currently only shortlists with a single Service included are supported. |\n| `request` | `1..1` | An initial message outlining the request. Maximum 8000 characters. |\n| `referringClinician` | `0..1` | Detail the Referring Clinician that a Referring Clinician Admin is acting on behalf off. Only permitted when creating an Advice Request as a user using the Referring Clinician Admin business function where it is also mandatory. |\n| `requestAttachmentFile` | `0..*` | A set of attachments to be included with the initial request. |\n", + "items": { + "anyOf": [ + { + "title": "Patient", + "description": "Parameter to supply a patient", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "patient" + ], + "example": "patient" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + { + "title": "ProviderConversionAuthorisation", + "description": "Parameter to define the Provider's conversion authorisation", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "providerConversionAuthorisation" + ], + "example": "providerConversionAuthorisation" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + }, + "code": { + "type": "string", + "enum": [ + "AUTHORISED_TO_CONVERT", + "NOT_AUTHORISED_TO_CONVERT" + ], + "example": "AUTHORISED_TO_CONVERT" + } + } + } + } + }, + { + "title": "Shortlist", + "description": "Parameter to supply a shortlist", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "shortlist" + ], + "example": "shortlist" + }, + "resource": { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + } + } + }, + { + "title": "request", + "description": "Parameter to supply a request", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "request" + ], + "example": "request" + }, + "valueString": { + "type": "string", + "example": "Please provide some advice around this case." + } + } + }, + { + "title": "ReferringClinician", + "description": "Parameter to supply a referring clinician", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "referringClinician" + ], + "example": "referringClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "requestAttachmentFile", + "description": "Parameter to supply an attachment alongside a request", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "requestAttachmentFile" + ], + "example": "requestAttachmentFile" + }, + "resource": { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "ADVICE_REQUEST" + ], + "example": "ADVICE_REQUEST" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "url" + ], + "properties": { + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + } + } + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "rca-with-attachments": { + "summary": "Example created by RCA with attachments authorising the provider to convert to a referral request.", + "value": { + "$ref": "../../examples/createAdviceAndGuidance/requests/ExampleRCAWithAttachments.json" + } + }, + "rc-without-attachments": { + "summary": "Example created by RC without attachments not authorising the provider to convert to a referral request.", + "value": { + "$ref": "../../examples/createAdviceAndGuidance/requests/ExampleRCWithoutAttachments.json" + } + } + } + } + } + }, + "responses": { + "200": { + "description": "An Advice And Guidance Request created within e-RS.", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-CreateAdvice-Response-Parameters", + "type": "object", + "required": [ + "resourceType", + "meta", + "parameter" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ] + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Response-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Response-Parameters-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "parameter": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | -------------------------------------------------------------|\n| `createdCommunicationRequest` | `1..1` | The created Advice And Guidance Request summary resource. |\n| `createdCommunication` | `1..1` | The created Initial Request message within the conversation. |\n", + "items": { + "anyOf": [ + { + "title": "createdCommunicationRequest", + "description": "The created Advice Request summary resource.", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "createdCommunicationRequest" + ], + "example": "createdCommunicationRequest" + }, + "resource": { + "title": "eRS-CommunicationRequest", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "contained", + "extension", + "status", + "category", + "subject", + "recipient", + "sender", + "requester", + "identifier" + ], + "properties": { + "id": { + "type": "string", + "example": "000000070000" + }, + "meta": { + "type": "object", + "required": [ + "profile", + "versionId" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" + } + }, + "versionId": { + "type": "string", + "example": "3" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "CommunicationRequest" + ], + "example": "CommunicationRequest" + }, + "contained": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", + "items": { + "anyOf": [ + { + "title": "eRS-Shortlist-List", + "description": "A list of services representing the services available to the patient to have treatment at", + "type": "object", + "required": [ + "status", + "mode", + "meta", + "resourceType", + "entry" + ], + "properties": { + "id": { + "type": "string", + "example": "shortlist" + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "mode": { + "type": "string", + "enum": [ + "snapshot" + ], + "example": "snapshot" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" + } + } + } + }, + "contained": { + "type": "array", + "items": { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + } + }, + "extension": { + "type": "array", + "nullable": true, + "maxItems": 1, + "minItems": 1, + "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-Shortlist-SearchCriteria", + "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#serviceSearchCriteria" + } + } + } + } + } + ] + } + }, + "resourceType": { + "type": "string", + "enum": [ + "List" + ], + "example": "List" + }, + "entry": { + "type": "array", + "items": { + "title": "Singular entry with service details", + "type": "object", + "required": [ + "item" + ], + "properties": { + "item": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + }, + "display": { + "type": "string", + "example": "Good Cardiology Business Service" + } + } + } + } + }, + "minItems": 1, + "maxItems": 20 + } + } + }, + { + "title": "eRS-ServiceSearchCriteria-Parameters", + "description": "The criteria used to search for services", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "parameter" + ], + "properties": { + "id": { + "type": "string", + "example": "serviceSearchCriteria" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Parameters" + ], + "example": "Parameters" + }, + "parameter": { + "type": "array", + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", + "items": { + "anyOf": [ + { + "title": "Priority", + "description": "Details the priority parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "priority" + ], + "example": "priority" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + }, + { + "title": "Specialty", + "description": "Details the specialty parameter", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "specialty" + ], + "example": "specialty" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + } + } + } + } + }, + { + "title": "ClinicType", + "description": "Details the clinic type that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicType" + ], + "example": "clinicType" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" + }, + "code": { + "type": "string", + "example": "HEART_FAILURE" + } + } + } + } + }, + { + "title": "IndicativeAppointmentWaitTimeLimit", + "description": "Details the indicative appointment wait time limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "indicativeAppointmentWaitTimeLimit" + ], + "example": "indicativeAppointmentWaitTimeLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 50 + } + } + }, + { + "title": "Postcode", + "description": "Details the postcode value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "postcode" + ], + "example": "postcode" + }, + "valueString": { + "type": "string", + "example": "LS1 2UT" + } + } + }, + { + "title": "DistanceLimit", + "description": "Details the distance limit value specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueUnsignedInt" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "distanceLimit" + ], + "example": "distanceLimit" + }, + "valueUnsignedInt": { + "type": "integer", + "minimum": 0, + "format": "int32", + "example": 123 + } + } + }, + { + "title": "ClinicalTerm", + "description": "Details the clinical term that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "clinicalTerm" + ], + "example": "clinicalTerm" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://snomed.info/sct" + ], + "example": "http://snomed.info/sct" + }, + "code": { + "type": "string", + "example": "1003" + } + } + } + } + }, + { + "title": "NamedClinician", + "description": "Details the named clinician that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "namedClinician" + ], + "example": "namedClinician" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + { + "title": "AgeAndGenderAppropriate", + "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", + "type": "object", + "required": [ + "name", + "valueBoolean" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "ageAndGenderAppropriate" + ], + "example": "ageAndGenderAppropriate" + }, + "valueBoolean": { + "type": "boolean", + "example": true + } + } + }, + { + "title": "CommissioningProvisioning", + "description": "Details the commissioning provisioning flag detailed in a search criteria", + "type": "object", + "required": [ + "name", + "valueCoding" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "commissioningProvisioning" + ], + "example": "commissioningProvisioning" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" + }, + "code": { + "type": "string", + "enum": [ + "ALL_AVAILABLE_FOR_BOOKING", + "ALL_SERVICES", + "LOCALLY_COMMISSIONABLE", + "NATIONALLY_AVAILABLE" + ], + "example": "ALL_AVAILABLE_FOR_BOOKING" + } + } + } + } + }, + { + "title": "Organisation", + "description": "Details the organisation that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueIdentifier" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "organisation" + ], + "example": "organisation" + }, + "valueIdentifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://directory.spineservices.nhs.uk/STU3/Organization" + ], + "example": "https://directory.spineservices.nhs.uk/STU3/Organization" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + { + "title": "Place", + "description": "Details the place that was specified in a search criteria", + "type": "object", + "required": [ + "name", + "valueString" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "place" + ], + "example": "place" + }, + "valueString": { + "type": "string", + "example": "Leeds" + } + } + } + ] + } + } + } + }, + { + "title": "DocumentReference", + "description": "A reference to a document", + "type": "object", + "required": [ + "meta", + "resourceType", + "type", + "status", + "indexed", + "content" + ], + "properties": { + "id": { + "type": "string", + "example": "DocumentReference-70002" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "DocumentReference" + ], + "example": "DocumentReference" + }, + "type": { + "type": "object", + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" + }, + "code": { + "type": "string", + "enum": [ + "REFERRER", + "PROVIDER", + "ADVICE_REQUEST", + "GUIDANCE_RESPONSE" + ], + "example": "REFERRER" + }, + "display": { + "type": "string", + "enum": [ + "Referrer", + "Provider", + "Advice Request", + "Guidance Response" + ], + "example": "Referrer" + } + } + } + } + } + }, + "status": { + "type": "string", + "enum": [ + "current" + ], + "example": "current" + }, + "indexed": { + "type": "string", + "format": "date-time", + "example": "2021-04-22T10:00:00.000Z" + }, + "description": { + "type": "string", + "nullable": true, + "example": "upload png" + }, + "content": { + "type": "array", + "minItems": 1, + "items": { + "type": "object", + "required": [ + "attachment" + ], + "properties": { + "attachment": { + "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", + "type": "object", + "required": [ + "contentType", + "url", + "size", + "title", + "creation" + ], + "properties": { + "id": { + "type": "string", + "example": "70002" + }, + "contentType": { + "type": "string", + "example": "image/png" + }, + "url": { + "type": "string", + "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" + }, + "size": { + "type": "integer", + "example": 6 + }, + "title": { + "type": "string", + "example": "upload.png" + }, + "creation": { + "type": "string", + "format": "date", + "example": "2021-04-22" + }, + "extension": { + "type": "array", + "minItems": 2, + "maxItems": 4, + "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", + "items": { + "oneOf": [ + { + "title": "Extension-eRS-AvailabilityStatus", + "description": "Details whether a file is available to be downloaded. See the Important note section for further information", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "AVAILABLE", + "PENDING", + "THREATS_FOUND", + "VALIDATION_FAILED" + ], + "example": "AVAILABLE" + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedBy", + "description": "Extension to indicate the individual who attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-AttachedByOrganisation", + "description": "Extension to indicate the organisation that attached a file within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-OnBehalfOf", + "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + } + } + } + ] + } + } + } + } + } + } + } + } + }, + { + "title": "CareConnect-PractitionerRole", + "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "practitioner", + "organization" + ], + "properties": { + "id": { + "type": "string", + "example": "PractitionerRole-R69-000000000101" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + ], + "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "PractitionerRole" + ], + "example": "PractitionerRole" + }, + "practitioner": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/sds-user-id" + ], + "example": "http://fhir.nhs.net/Id/sds-user-id" + }, + "value": { + "type": "string", + "example": "021600556514" + } + } + } + } + }, + "organization": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + }, + "code": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" + }, + "code": { + "type": "string", + "example": "REFERRING_CLINICIAN" + } + } + } + } + } + } + } + } + } + ] + } + }, + "extension": { + "type": "array", + "nullable": true, + "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", + "items": { + "anyOf": [ + { + "title": "Extension-eRS-ReferralShortlist", + "description": "Extension to supply the current shortlist for a ReferralRequest", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#shortlist" + } + } + } + } + }, + { + "title": "Extension-eRS-ReferralPriority", + "description": "Extension to supply the current priority of a ReferralRequest within e-RS", + "type": "object", + "required": [ + "url", + "valueCodeableConcept" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" + }, + "valueCodeableConcept": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" + }, + "code": { + "type": "string", + "enum": [ + "ROUTINE", + "URGENT", + "TWO_WEEK_WAIT" + ], + "example": "URGENT" + }, + "display": { + "description": "display value is returned in response from the server", + "nullable": true, + "type": "string", + "example": "Urgent" + } + } + } + } + } + } + } + }, + { + "title": "Extension-eRS-ProviderConversionAuthorisation", + "description": "Extension to supply the conversion authorisation flag", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" + }, + "code": { + "type": "string", + "enum": [ + "AUTHORISED_TO_CONVERT", + "NOT_AUTHORISED_TO_CONVERT" + ], + "example": "NOT_AUTHORISED_TO_CONVERT" + }, + "display": { + "type": "string", + "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" + } + } + } + } + }, + { + "title": "Extension-eRS-Specialty", + "description": "Extension to supply the specialty", + "type": "object", + "required": [ + "url", + "valueCoding" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" + }, + "valueCoding": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" + }, + "code": { + "type": "string", + "example": "CARDIOLOGY" + }, + "display": { + "type": "string", + "example": "Cardiology" + } + } + } + } + } + ] + } + }, + "status": { + "type": "string", + "enum": [ + "active", + "cancelled", + "completed" + ], + "example": "active" + }, + "category": { + "type": "array", + "nullable": true, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" + }, + "code": { + "type": "string", + "enum": [ + "PROVIDER_RESPONSE_REQUIRED", + "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", + "REFERRER_TO_REVIEW_RESPONSE", + "CONVERSATION_ENDED_CANCELLED", + "CONVERSATION_ENDED_CLOSED", + "ADVICE_CONVERTED" + ], + "example": "PROVIDER_RESPONSE_REQUIRED" + } + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/nhs-number" + ], + "example": "http://fhir.nhs.net/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + }, + "recipient": { + "type": "array", + "items": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + } + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "requester": { + "type": "object", + "required": [ + "agent" + ], + "properties": { + "agent": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#DocumentReference-70002" + } + } + } + } + } + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "enum": [ + "https://fhir.nhs.uk/Id/ers-request-id" + ], + "example": "https://fhir.nhs.uk/Id/ers-request-id" + }, + "value": { + "type": "string", + "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + } + } + } + } + } + } + } + }, + { + "title": "createdCommunication", + "description": "The created initial request message within the conversation.", + "type": "object", + "required": [ + "name", + "resource" + ], + "properties": { + "name": { + "type": "string", + "enum": [ + "createdCommunication" + ], + "example": "createdCommunication" + }, + "resource": { + "title": "eRS-Communication-1", + "description": "A record of information transmitted from a sender to a receiver", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "status", + "category", + "recipient", + "sent", + "sender", + "note" + ], + "properties": { + "id": { + "type": "string", + "example": "appointment" + }, + "meta": { + "type": "object", + "required": [ + "profile" + ], + "properties": { + "profile": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1", + "https://fhir.hl7.org.uk/STU3/StructureDefinition/eRS-Communication-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1" + } + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "Communication" + ], + "example": "Communication" + }, + "status": { + "type": "string", + "enum": [ + "completed" + ], + "example": "completed" + }, + "category": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" + }, + "code": { + "type": "string", + "enum": [ + "REQUESTER", + "RESPONDER", + "REFERRER_CLINICAL_INFORMATION_UPDATED" + ], + "example": "REQUESTER" + } + } + } + } + } + } + }, + "recipient": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "anyOf": [ + { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-HealthcareService-Reference", + "description": "Extension to supply the service id", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "http://fhir.nhs.net/Id/ers-service" + ], + "example": "http://fhir.nhs.net/Id/ers-service" + }, + "value": { + "type": "string", + "example": "11002" + } + } + } + } + } + } + } + } + } + }, + { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/ods-organization-code" + ], + "example": "https://fhir.nhs.uk/Id/ods-organization-code" + }, + "value": { + "type": "string", + "example": "R69" + } + } + } + } + } + ] + } + }, + "sent": { + "type": "string", + "format": "date-time", + "example": "2021-04-20T12:17:35.128Z" + }, + "sender": { + "type": "object", + "required": [ + "extension" + ], + "properties": { + "extension": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "title": "Extension-PractitionerRole-Reference", + "description": "Extension to supply practitioner details", + "type": "object", + "required": [ + "url", + "valueReference" + ], + "properties": { + "url": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" + }, + "valueReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" + } + } + } + } + } + } + } + }, + "payload": { + "type": "array", + "items": { + "type": "object", + "required": [ + "contentReference" + ], + "properties": { + "contentReference": { + "type": "object", + "required": [ + "reference" + ], + "properties": { + "reference": { + "type": "string", + "example": "DocumentReference/70000" + } + } + } + } + } + }, + "note": { + "type": "array", + "minItems": 1, + "maxItems": 1, + "items": { + "type": "object", + "required": [ + "text" + ], + "properties": { + "text": { + "type": "string", + "example": "Example content...", + "description": "Maximum 8000 characters." + } + } + } + } + } + } + } + } + ] + } + } + } + }, + "examples": { + "rca-with-attachments": { + "summary": "Example created by RCA with attachments authorising the provider to convert to a referral request.", + "value": { + "$ref": "../../../examples/createAdviceAndGuidance/responses/ExampleRCAWithAttachments.json" + } + }, + "rc-without-attachments": { + "summary": "Example created by RC without attachments not authorising the provider to convert to a referral request.", + "value": { + "$ref": "../../../examples/createAdviceAndGuidance/responses/ExampleRCWithoutAttachments.json" + } + } + } + } + } + }, + "400": { + "description": "Bad Request" + }, + "401": { + "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "NO_ACCESS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "FORBIDDEN", + "display": "Forbidden" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Not Acceptable", + "headers": { + "Content-Type": { + "description": "Indicates the media type of the associated resource. \n", + "schema": { + "type": "string", + "enum": [ + "text/plain;charset=utf-8" + ], + "example": "text/plain;charset=utf-8" + } + } + }, + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "415": { + "description": "Unsupported Media Type", + "content": { + "text/plain;charset=utf-8": { + "schema": { + "type": "string" + } + } + } + }, + "422": { + "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "value", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "UNEXPECTED_FIELD", + "display": "Unexpected field" + } + ] + }, + "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" + } + ] + } + } + } + }, + "429": { + "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" + }, + "500": { + "description": "Internal Server Error" + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "eRS-OperationOutcome", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "properties": { + "profile": { + "type": "array", + "items": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ], + "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + }, + "minItems": 1, + "maxItems": 1 + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "example": "error" + }, + "code": { + "type": "string", + "example": "business-rule" + }, + "diagnostics": { + "type": "string", + "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code", + "display" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ], + "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + }, + "code": { + "type": "string", + "example": "DUPLICATE_SERVICE" + }, + "display": { + "type": "string", + "example": "Duplicate service found in shortlist" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "meta": { + "profile": [ + "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ] + }, + "resourceType": "OperationOutcome", + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", + "code": "SYSTEM_UNAVAILABLE", + "display": "System Unavailable" + } + ] + } + } + ] + } + } + } + } + } + } + }, + "/R4/ServiceRequest": { + "get": { + "security": [ + { + "bearerAuth": [] + } + ], + "description": "## Overview\n\n

\nWarning: This endpoint is part of a new suite of APIs currently in development. We currently advise against integrating with this endpoint as its definition may be subject to change. If you would still like to use this endpoint please contact us before you start integration.\n

\n\nThe e-RS FHIR API represents an advice and guidance request and a referral in FHIR R4 as a ServiceRequest. This endpoint allows you to search for attributes about a ServiceRequest.\n\nAt present the following is the only permitted use case for using this endpoint, but it is expected that additional use cases will be added as future needs are identified and prioritised.\n- For FHIR R4 endpoints, the e-RS FHIR API requires a unique identifier for the ServiceRequest, instead of the UBRN, to identify an advice and guidance request or referral request. To support partners to transition from previous FHIR versions, and utilise the newer FHIR endpoints, this endpoint can be used as a bridging mechanism so that you can search for the required unique identifiers using a UBRN. \n\n## Supported security patterns\n\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nTo use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles:\n\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n- `SERVICE_PROVIDER_CLINICIAN`\n- `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the Unique Booking Reference Number (UBRN) of an advice and guidance request or referral request.\n\n\n## Important notes\n\nWhen searching for a unique identifier for a ServiceRequest, it's important to note that one UBRN can relate to both an advice and guidance request and a referral. In this case, the response could contain two unique identifiers: one relating to the advice and guidance request and one relating to the referral.\n\n## Use case\n\nAs an authenticated user\n\nI need the unique identifier for a given advice and guidance request or referral request\n\nSo that I can view or action an advice and guidance request or referral\n\n## Related endpoints\n\nOnce the ServiceRequest's unique identifier has been retrieved it can then be used to call the following endpoints to manage its clinical attachments:\n- [[HYPERLINK_A012]]\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | UBRN |\n| --------------------------------------------------------------------------------------- | -------------- |\n| A response containing a single Request ID for a `ServiceRequest` of category `referral` | `000000070000` |\n| A response containing a single Request ID for a `ServiceRequest` of category `request` | `000000070001` |\n| A response containing two Request IDs | `000000070002` |\n| A response containing an empty bundle | `000000070003` |\n", + "summary": "Search for service requests (A041, FHIR R4)", + "operationId": "a041-search-service-request", + "tags": [ + "Retrieve clinical information" + ], + "parameters": [ + { + "in": "header", + "name": "Authorization", + "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", + "required": true, + "schema": { + "type": "string", + "format": "^Bearer\\ [[:ascii:]]+$", + "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" + } + }, + { + "in": "header", + "name": "NHSD-eRS-Business-Function", + "description": "The e-RS Business Function of the caller\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "REFERRING_CLINICIAN", + "REFERRING_CLINICIAN_ADMIN", + "REFERRING_ADMIN", + "COMMISSIONER", + "SERVICE_PROVIDER_CLINICIAN_ADMIN", + "SERVICE_PROVIDER_CLINICIAN", + "SERVICE_PROVIDER_ADMIN", + "INFORMATION_ANALYST", + "BOOKING_MANAGER", + "ADDITIONAL_REQUIREMENTS_MANAGER" + ], + "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" + } + }, + { + "in": "header", + "name": "X-Correlation-ID", + "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + { + "in": "header", + "name": "NHSD-End-User-Organisation-ODS", + "description": "The ODS code of the caller's Organisation\n", + "required": true, + "schema": { + "type": "string", + "example": "R69" + } + }, + { + "in": "header", + "name": "NHSD-eRS-On-Behalf-Of-User-ID", + "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", + "required": false, + "schema": { + "type": "string", + "example": "021600556514" + } + }, + { + "name": "identifier", + "in": "query", + "description": "The Unique Booking Reference Number (UBRN) used to search for `ServiceRequest` resources.\nThe format follows that of a [token](https://www.hl7.org/fhir/r4/search.html#token), with `code` (UBRN) being mandatory and `system` being optional.\nIn this case, the code system will be eRS UBRN (https://fhir.nhs.uk/Id/UBRN).\n- [parameter]=[code]\n- [parameter]=[system]|[code]\n", + "required": true, + "style": "form", + "explode": false, + "schema": { + "type": "string", + "format": "token" + }, + "examples": { + "system_and_ubrn": { + "value": "https://fhir.nhs.uk/Id/UBRN|000000070000", + "summary": "Code system and UBRN" + }, + "ubrn": { + "value": "000000070000", + "summary": "UBRN only" + } + } + } + ], + "responses": { + "200": { + "description": "Bundle resource containing the `ServiceRequest` resources associated to the supplied UBRN. \nThe canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "type": "object", + "required": [ + "id", + "meta", + "type", + "timestamp", + "total", + "link" + ], + "properties": { + "id": { + "type": "string", + "example": "123e4567-e89b-12d3-a456-426614174000" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "type": { + "type": "string", + "enum": [ + "searchset" + ], + "example": "searchset" + }, + "timestamp": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + }, + "total": { + "type": "integer", + "example": 1 + }, + "link": { + "type": "array", + "items": { + "type": "object", + "required": [ + "relation", + "url" + ], + "properties": { + "relation": { + "type": "string", + "enum": [ + "self" + ], + "example": "self" + }, + "url": { + "type": "string", + "example": "_baseUrl_/FHIR/R4/ServiceRequest?identifier=https://fhir.nhs.uk/Id/UBRN%7C000000070000" + } + } + } + }, + "entry": { + "type": "array", + "description": "| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `ServiceRequest` | `0..*` | |\n", + "items": { + "title": "ServiceRequest", + "type": "object", + "required": [ + "fullUrl", + "resource", + "search" + ], + "properties": { + "fullUrl": { + "type": "string", + "example": "_baseUrl_/FHIR/R4/ServiceRequest/r.123e4567-e89b-12d3-a456-426614174000" + }, + "resource": { + "title": "eRS-ServiceRequest", + "description": "A record of a request for service such as diagnostic investigations, treatments, or operations to be performed.\nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-ServiceRequest\n", + "type": "object", + "required": [ + "id", + "meta", + "resourceType", + "identifier", + "status", + "intent", + "category", + "subject" + ], + "properties": { + "id": { + "type": "string", + "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" + }, + "meta": { + "type": "object", + "required": [ + "versionId" + ], + "properties": { + "versionId": { + "type": "string", + "example": "5" + } + } + }, + "resourceType": { + "type": "string", + "enum": [ + "ServiceRequest" + ], + "example": "ServiceRequest" + }, + "identifier": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/UBRN" + ], + "example": "https://fhir.nhs.uk/Id/UBRN" + }, + "value": { + "type": "string", + "example": "000000070000" + } + } + } + }, + "status": { + "type": "string", + "description": "Whilst a potential value to return is `draft`, we are not currently returning this value, but may choose to do so in the future.\n\n| ServiceRequest.status | Description |\n|-----------------------|---------------------------------------------------------------------------------- |\n| active | The `ServiceRequest` is ready to be acted upon. |\n| completed | The `ServiceRequest` has been fully performed and no further activity will occur. |\n| draft | The `ServiceRequest` is incomplete and is not yet ready to be processed. |\n| revoked | The `ServiceRequest` has been terminated and no further activity will occur. |\n", + "enum": [ + "active", + "completed", + "draft", + "revoked" + ], + "example": "active" + }, + "intent": { + "type": "string", + "enum": [ + "order" + ], + "example": "order" + }, + "category": { + "type": "array", + "items": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/message-category-servicerequest" + ] + }, + "code": { + "type": "string", + "enum": [ + "referral", + "request" + ], + "example": "referral" + } + } + } + } + } + } + }, + "code": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/servicerequest-code" + ], + "example": "https://fhir.nhs.uk/CodeSystem/servicerequest-code" + }, + "code": { + "type": "string", + "enum": [ + "advice-and-guidance" + ], + "example": "advice-and-guidance" + } + } + } + } + } + }, + "subject": { + "type": "object", + "required": [ + "identifier" + ], + "properties": { + "identifier": { + "type": "object", + "required": [ + "system", + "value" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/Id/nhs-number" + ], + "example": "https://fhir.nhs.uk/Id/nhs-number" + }, + "value": { + "type": "string", + "example": "9912003888" + } + } + } + } + } + } + }, + "search": { + "type": "object", + "required": [ + "mode" + ], + "properties": { + "mode": { + "type": "string", + "enum": [ + "match" + ], + "example": "match" + } + } + } + } + } + } + } + }, + "examples": { + "minimal-example-empty": { + "summary": "An empty bundle might be returned when the search completes but matches no requests.", + "value": { + "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleEmpty.json" + } + }, + "minimal-example-referral": { + "summary": "A response containing a single Request ID for a `ServiceRequest` of category `referral`.", + "value": { + "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleReferral.json" + } + }, + "minimal-example-advice": { + "summary": "A response containing a single Request ID for a `ServiceRequest` of category `request`.", + "value": { + "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleAdvice.json" + } + }, + "complex-example-referral-and-advice": { + "summary": "A response containing two Request IDs.", + "value": { + "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleReferralAndAdvice.json" + } + } + } + } + } + }, + "400": { + "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------ |\n| REC_BAD_REQUEST | required | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | Incorrect or missing expected value. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_BAD_REQUEST" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "401": { + "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "login", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "ACCESS_DENIED" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "403": { + "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "forbidden", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_FORBIDDEN" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "406": { + "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "not-supported", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_NOT_ACCEPTABLE" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "429": { + "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "throttled", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "code": "TOO_MANY_REQUESTS" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "500": { + "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "exception", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_SERVER_ERROR" + } + ] + }, + "diagnostics": "Example diagnostics message." + } + ] + } + } + } + }, + "503": { + "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", + "headers": { + "X-Correlation-ID": { + "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", + "required": false, + "schema": { + "type": "string", + "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" + } + }, + "X-Request-ID": { + "description": "The e-RS transaction id\n", + "required": false, + "schema": { + "type": "string", + "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" + } + }, + "Content-Type": { + "description": "Indicates the media type of the associated resource.\n", + "required": true, + "schema": { + "type": "string", + "enum": [ + "application/fhir+json" + ], + "example": "application/fhir+json" + } + }, + "Retry-After": { + "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", + "required": false, + "schema": { + "type": "string", + "example": "120" + } + } + }, + "content": { + "application/fhir+json": { + "schema": { + "title": "NHSDigital-OperationOutcome", + "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", + "type": "object", + "required": [ + "resourceType", + "meta", + "issue" + ], + "properties": { + "resourceType": { + "type": "string", + "enum": [ + "OperationOutcome" + ], + "example": "OperationOutcome" + }, + "meta": { + "type": "object", + "required": [ + "lastUpdated" + ], + "properties": { + "lastUpdated": { + "type": "string", + "format": "date-time", + "example": "2021-08-04T14:35:00.000Z" + } + } + }, + "issue": { + "type": "array", + "items": { + "type": "object", + "required": [ + "severity", + "code", + "details" + ], + "properties": { + "severity": { + "type": "string", + "enum": [ + "fatal", + "error", + "warning", + "information" + ], + "example": "error" + }, + "code": { + "type": "string", + "example": "required" + }, + "diagnostics": { + "type": "string", + "example": "Incorrect or missing expected value." + }, + "details": { + "type": "object", + "required": [ + "coding" + ], + "properties": { + "coding": { + "type": "array", + "items": { + "type": "object", + "required": [ + "system", + "code" + ], + "properties": { + "system": { + "type": "string", + "enum": [ + "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", + "https://fhir.nhs.uk/CodeSystem/ers-error-codes" + ], + "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" + }, + "code": { + "type": "string", + "example": "REC_BAD_REQUEST" + } + } + } + } + } + } + } + } + } + } + }, + "example": { + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "transient", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", + "code": "REC_UNAVAILABLE" + } + ] + } + } + ] + } + } + } + } + } + } + } + }, + "components": { + "securitySchemes": { + "bearerAuth": { + "type": "http", + "scheme": "bearer", + "bearerFormat": "JWT" + } + }, + "mediaTypes": { + "FileContentTypeSchemaDownload": { + "text/plain": { + "schema": { + "type": "string", + "format": "binary" + }, + "example": "This is some example text." + }, + "text/html": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/xml": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/rtf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/basic": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/png": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/gif": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/jpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/tiff": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "video/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/msword": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/dicom": { + "schema": { + "type": "string", + "format": "binary" + } + } + }, + "FileContentTypeSchemaUpload": { + "text/plain": { + "schema": { + "type": "string", + "format": "binary" + }, + "example": "This is some example text." + }, + "application/pdf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/xml": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "text/rtf": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/basic": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "audio/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/png": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/gif": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/jpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "image/tiff": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "video/mpeg": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/msword": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { + "schema": { + "type": "string", + "format": "binary" + } + }, + "application/dicom": { + "schema": { + "type": "string", + "format": "binary" + } + } + } + } + }, + "x-nhsd-api-platform": { + "meta": { + "service_name": "e-referrals-service-api", + "short_service_name": "ers", + "service_base_path": "referrals", + "product_display_name": "e-Referrals-Service", + "product_description": "The NHS e-RS vision is to enable local innovation and adoption of paperless referrals. To support this vision NHS Digital have created a set of APIs which provide a well-defined, simple to use data interface to the NHS e-Referral Service (e-RS). See https://digital.nhs.uk/developer/api-catalogue/e-referral-service-fhir", + "pipeline_name_prefix": "E-Referrals-Service" + } + } +} \ No newline at end of file From dd84bbf7cb38d9977db25ebc53f74d15fc943192 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Mon, 30 Mar 2026 15:11:54 +0100 Subject: [PATCH 35/55] Delete test-output.json --- test-output.json | 100528 -------------------------------------------- 1 file changed, 100528 deletions(-) delete mode 100644 test-output.json diff --git a/test-output.json b/test-output.json deleted file mode 100644 index 296c6b43e..000000000 --- a/test-output.json +++ /dev/null @@ -1,100528 +0,0 @@ -[1] redocly.yaml:6:3 at #/rules/info-license-url - -Property `info-license-url` is not expected here. - -4 | no-invalid-media-type-examples: -5 | severity: off -6 | info-license-url: off - | ^^^^^^^^^^^^^^^^ -7 | tag-description: off -8 | - -Warning was generated by the configuration struct rule. - - -{ - "openapi": "3.0.0", - "info": { - "version": "0.0.1", - "title": "e-Referrals Service", - "description": "## Overview\nUse this API to create paperless referrals from primary to secondary care with the [e-Referral Service (e-RS)](https://digital.nhs.uk/services/e-referral-service).\n\nFor an overview of how you can plan and prepare for your integration with e-RS, see our [API onboarding guide](https://digital.nhs.uk/services/e-referral-service/api).\n\n**As a primary care referrer, you can:**\n\n -\tcreate a new e-referral\n - search for relevant patient services to create a shortlist\n -\taccess existing e-referrals\n -\tcreate a triage request for the Referral Assessment Service (RAS)\n -\tupload and manage a patient letter or attachments, linking them to a referral\n -\tretrieve appointment slots and book appointments\n -\tdefer a booking to a provider if an appointment slot is unavailable\n - create a new advice and guidance request\n\n**As a secondary care provider, you can:**\n\n -\taccess referrals as a worklist\n -\tretrieve non-clinical information (meta-data) about the referral\n -\tretrieve attachments which are linked to a referral or triage (RAS) request\n -\tretrieve clinical information which has been provided by a referrer\n -\taccept or reject a referral request\n -\tretrieve Advice & Guidance (A&G) conversations and send responses\n -\tconvert Advice & Guidance (A&G) conversations into a referral\n - cancel a referral\n\n**You cannot use this API to:**\n\n -\tget patient details - instead, use the [[HYPERLINK_PDS]]\n\n**You can access the following data:**\n\n -\treferral attachments\n -\treferral letters\n -\tappointment slots\n -\tworklists for referral requests\n -\tworklists for triage (RAS) requests\n -\tworklists for Advice and Guidance (A&G) requests\n -\tconversation histories for Advice and Guidance (A&G) requests\n\n
\n
\n
\n
\n \n \"\"\n \n
\n
\n
\n
\n

To discover the most common use cases, see our Building Healthcare Software guides.

\n
\n
\n
\n
\n\n### Access modes\n\nThis API has two access modes:\n\n| Access mode | Authentication via | Functions | Availability |\n| ----------------------------- | -------------------------- | ----------------------- | ------------------------------- |\n| Application-restricted,
unattended access | [[HYPERLINK_SIGNED_JWT]] |
  • [[HYPERLINK_A004]]
  • [[HYPERLINK_A005]]
  • [[HYPERLINK_A007]]
  • [[HYPERLINK_A008]]
  • [[HYPERLINK_A013]]
  • [[HYPERLINK_A024]]
  • [[HYPERLINK_A025]]
  • [[HYPERLINK_A028]]
  • [[HYPERLINK_A029]]
  • [[HYPERLINK_A033]]
  • [[HYPERLINK_A035]]
  • [[HYPERLINK_A036]]
  • [[HYPERLINK_A037]]
  • [[HYPERLINK_A042]]
  • [[HYPERLINK_A043]]
| [[HYPERLINK_PRODUCTION]] |\n| Healthcare worker,
user-restricted access | [[HYPERLINK_CIS_AUTH_SHORT]] | All Endpoints | [[HYPERLINK_PRODUCTION]] |\n\n##### Application-restricted, unattended access\n\nThis access mode has been introduced to allow a Partner application which has been [registered with us](https://portal.developer.nhs.uk/create-a-developer-account) and [authenticated via signed JWT](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/application-restricted-restful-apis-signed-jwt-authentication) to interact with a subset of e-RS FHIR API endpoints in an unattended and read-only fashion.\nApplication-restricted, unattended access should only be used when authenticating a human user (for example via smartcard) is not possible.\n\nWrite operations are currently supported for specific use cases via:\n- [[HYPERLINK_A028]]\n- [[HYPERLINK_A013]]\n- [[HYPERLINK_A036]]\n\nYou will be required to submit your use case for review when using these endpoints via application-restricted, unattended access.\n\n##### Healthcare worker, user-restricted access\n\nThis access mode allows Partner applications to access e-RS FHIR API endpoints by authenticating users with [[HYPERLINK_CIS_AUTH_LONG]].\n\nThis access mode must be used for writing changes (such as Create Referral).\n\n## Who can use this API\n\nYou can use this API if you are a software developer wishing to interact with the e-referrals service (e-RS) data, for use in a professional, clinical setting. \n\nTo use this API you must:\n\n -\thave justification for doing so\n -\t[register with us](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1-design#1-8-register-with-us)\n -\tensure you have a [valid use case](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1-design#1-2-validate-your-use-case) before you go too far with your development\n -\t[assure](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-3-assure) your solution before we grant access to live data\n\n## Related APIs\n\n[HL7 V3 API](https://digital.nhs.uk/developer/api-catalogue/e-referral-service-hl7-v3) - this API allows you to manage appointment slots for a Patient Administration System (PAS). \n\n\n## API status and roadmap\n\n### This API has two access modes:\n - Application-restricted, unattended access\n - Healthcare worker, user-restricted access\n\n### Application-restricted, unattended access\n\nThis access mode is [[HYPERLINK_PRODUCTION]], meaning:\n - we avoid making routine [breaking changes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy#breaking-changes), except in exceptional circumstances\n - if we need to deprecate an endpoint, we will give advance notice on our [board](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/deprecation-notices). Our [sunsetting page](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy) details our deprecation and retirement policy.\n \n### Healthcare worker, user-restricted access\n\nThis access mode is [[HYPERLINK_PRODUCTION]], meaning:\n - we avoid making routine [breaking changes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy#breaking-changes), except in exceptional circumstances\n - if we need to deprecate an endpoint, we will give advance notice on our [board](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/deprecation-notices). Our [sunsetting page](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/sunsetting-policy) details our deprecation and retirement policy.\n\n### Roadmap\n\nVisit our [roadmap page](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/roadmap) for details of what we are working on.\n\nTo suggest, comment or vote on features for this API, see our [interactive product backlog](https://portal.productboard.com/qhpkcqgctqtk3ujk8jyoajp8/tabs/4-new-requests).\n\n## Service level\nThis API is a gold service, meaning it is operational and supported 24 hours a day, 365 days a year.\n\nFor more details, see [service levels](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#service-levels).\n\n## Technology\n\nThis API is primarily [RESTful](https://digital.nhs.uk/developer/guides-and-documentation/api-technologies-at-nhs-digital#basic-rest) \nand based on [FHIR](https://digital.nhs.uk/developer/guides-and-documentation/api-technologies-at-nhs-digital#fhir) global standards for health care data exchange.\n\nThis API supports FHIR STU3 and FHIR R4.\n\n### FHIR STU3\n\nThe e-RS FHIR STU3 API is built against the set of profiles called [CareConnect](https://nhsconnect.github.io/CareConnectAPI/).\n\n### FHIR R4\n\nThe e-RS FHIR R4 API is built alongside the [NHS England FHIR Implementation Guide](https://simplifier.net/guide/nhsdigital), which is built on top of [FHIR UK Core](https://digital.nhs.uk/services/fhir-uk-core). The canonical URLs listed in the schema can be resolved with [https://simplifier.net/resolve](https://simplifier.net/resolve).\n\n## Network access\n\nThis API is available on the internet and, indirectly, on the [Health and Social Care Network (HSCN)](https://digital.nhs.uk/services/health-and-social-care-network).\n\nTo use this API with NHS smartcards you do need an HSCN connection, although internet-facing alternatives are available.\n\nFor more details see [Network access for APIs](https://digital.nhs.uk/developer/guides-and-documentation/network-access-for-apis).\n\n\n## Security and authorisation\n\nThis API has two access modes:\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n### Application-restricted, unattended access\n\nThis access mode is [application-restricted](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#application-restricted-apis), meaning we authenticate the calling application but not the end user.\n\nYou can only use this access mode when authenticating a human user (for example via smartcard) is not possible.\n\nWrite operations are currently only supported by [[HYPERLINK_A028]] for non-clinical use cases. You will be required to submit your use case for review when using this endpoint via application-restricted, unattended access.\n\nTo use this access mode, use the following security pattern:\n- [Application-restricted RESTful API - signed JWT authentication](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/application-restricted-restful-apis-signed-jwt-authentication)\n\n### Healthcare worker, user-restricted access\n\nThis access mode is [user-restricted](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis), meaning an end user must be present, authenticated and authorised.\n\nThe end user must be:\n- present\n- a healthcare worker\n- strongly authenticated and authorised by [[HYPERLINK_CIS_AUTH_LONG]]\n\nIn order to successfully authenticate with CIS2, the NHS e-Referral Service requires end users to be authenticated to the following standards:\n - an [Identity Assurance Level (IAL)](https://digital.nhs.uk/services/care-identity-service/applications-and-services/cis2-authentication/guidance-for-developers/detailed-guidance/scopes-and-claims#claims ) of IAL3\n - an [Authenticator Assurance Level (AAL)](https://digital.nhs.uk/services/care-identity-service/applications-and-services/cis2-authentication/guidance-for-developers/detailed-guidance/acr-values#authentication-methods) of AAL2 or AAL3\n\nTo use this access mode, use one of the following security patterns:\n- [user-restricted RESTful API - using NHS CIS2 - combined authentication and authorisation](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/user-restricted-restful-apis-nhs-cis2-combined-authentication-and-authorisation)\n- [user-restricted RESTful API - using NHS CIS2 - separate authentication and authorisation](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation/user-restricted-restful-apis-nhs-cis2-separate-authentication-and-authorisation)\n\nWe strongly recommend the use of separate authentication and authorisation. This mode will provide you access to the healthcare workers identity, allowing you to reuse it across multiple applications such as PDS.\n\nYou can [learn more](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1.4---select-your-authentication-level#1-access-modes) about each access mode option on our onboarding guide.\n\n#### Role and Organisation Validation\nFor most e-RS endpoints requests are made in the context of a specific authorised e-RS Role at a specific Organisation for the authenticated user. \n\nThe e-RS Role is supplied to the endpoint via the `NHSD-eRS-Business-Function` request header. \n\nThe Organisation is supplied to the endpoint via the `NHSD-End-User-Organisation-ODS` request header. \n\nSuitable values for these request headers can be obtained from the Practitioner Role Bundle returned by [[HYPERLINK_A030]].\n\n#### On Behalf Of User\nIf the `SERVICE_PROVIDER_CLINICIAN_ADMIN` role is used then the User ID of the Service Provider Clinician that the Admin is acting on behalf of must be supplied via the `NHSD-eRS-On-Behalf-Of-User-ID` header.\n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC).\n\n## Environments and testing\n\n| Environment | Base URL |\n| ----------------- | ---------------------------------------------------------------------- |\n| Sandbox | `https://sandbox.api.service.nhs.uk/referrals/FHIR` |\n| Integration test | `https://int.api.service.nhs.uk/referrals/FHIR` |\n| Production | `https://api.service.nhs.uk/referrals/FHIR` |\n\n### Sandbox testing\n\nOur [sandbox](https://digital.nhs.uk/developer/guides-and-documentation/testing#sandbox-testing) environment:\n-\tis for developer education and early testing\n-\tonly covers a limited set of scenarios\n-\tis stateless, so does not actually persist any updates\n-\tis open access, so does not allow you to test authorisation\n\nTry out the sandbox using our 'Try this API' feature, see the documentation for each endpoint.\n\nThe sandbox will only respond to an input which exactly matches one of the examples provided; it is otherwise stateless.\n\n### Integration testing\n\nOur [integration test](https://digital.nhs.uk/developer/guides-and-documentation/testing#integration-testing-with-our-restful-apis) environment:\n -\tis where the majority of your integration efforts will take place\n - is where we conduct witness testing for your application\n -\tis stateful, so data will be persisted\n\n\n## Onboarding\n\nYou need to get your software approved by us before you can go live with this API. We call this onboarding. The onboarding process can sometimes be quite long, so it's worth planning well ahead.\n\nWe use the Supplier Conformance Assessment List (SCAL) process. [Learn more](https://digital.nhs.uk/services/e-referral-service/api/integration-process/stage-1-design#1-7-learn-how-to-onboard) about onboarding.\n\n## Errors\nWe use standard HTTP status codes to show whether an API request succeeded or not. They are usually in the range:\n* 200 to 299 if it succeeded, including code 202 if it was accepted by an API that needs to wait for further action\n* 400 to 499 if it failed because of a client error by your application\n* 500 to 599 if it failed because of an error on our server\n\nErrors specific to each API are shown in the Endpoints section, under Response. See our [reference guide](https://digital.nhs.uk/developer/guides-and-documentation/reference-guide#http-status-codes) for more on errors.\n", - "contact": { - "url": "https://digital.nhs.uk/developer/help-and-support", - "email": "api.management@nhs.net" - }, - "license": { - "name": "MIT" - } - }, - "servers": [ - { - "url": "https://sandbox.api.service.nhs.uk/referrals/FHIR", - "description": "Sandbox environment." - }, - { - "url": "https://int.api.service.nhs.uk/referrals/FHIR", - "description": "Integration test environment." - }, - { - "url": "https://api.service.nhs.uk/referrals/FHIR", - "description": "Production environment. Not yet available." - } - ], - "tags": [ - { - "name": "Retrieve user information" - }, - { - "name": "Refer patient" - }, - { - "name": "Arrange appointment" - }, - { - "name": "Arrange triage" - }, - { - "name": "Request advice" - }, - { - "name": "Retrieve healthcare service information" - }, - { - "name": "Change appointment" - }, - { - "name": "Manage referral" - }, - { - "name": "Retrieve clinical information" - }, - { - "name": "Review referral requests" - }, - { - "name": "Review advice and guidance requests" - } - ], - "paths": { - "/STU3/CodeSystem/{codeSystemType}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve a list of reference data codes along with the user-friendly display values used in the e-RS Professional Application.\n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider or Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Use case\nAs an authenticated user or application\n\nI need to retrieve e-RS reference data\n\nSo I can use it with other endpoints or display the reference data in a user-friendly format to my users.\n\n## Related endpoints\nReference data may be needed for other endpoints, for example when including Specialty and Clinic Type reference data to:\n- find services that meet the referral needs of a patient using [[HYPERLINK_A010]], and\n- create a referral using [[HYPERLINK_A011]]\n\nYou can use the Priority reference data to calculate when a patient can expect to be contacted by the service. \n\nThis is important because when a patient's appointment is deferred to a service to book, the patient may be informed of the date by which they can expect to be contacted. \nSimilarly, in the case of a triage service, a letter may inform the patient of the date by which they can expect to be contacted.\n\nYou can calculate this date by:\n\n1. Obtaining the current priority of the referral (via [[HYPERLINK_A005]]) and its associated \"deferToProviderContactDays\" (for deferred-to services) or \"triageContactDays\" (for triage services). These represent the number of \"working days\" and do not include weekends\n2. Obtaining the datetime of the appointment resource, e.g. \"created\" : \"2021-05-06T11:21:45.652Z\"\n3. Adding the \"working days\" to the datetime of the appointment resource\n\n For example:\n\n1. Given a referral with a priority of `TWO_WEEK_WAIT` and a \"deferToProviderContactDays\" of \"2\" for priority `TWO_WEEK_WAIT`\n2. If the appointment was created on Monday 03/01/2022 for a deferred-to service \n3. The calculated date when a patient can expect to be contacted by the service would be on or before 05/01/2022\n\nNote that the \"deferToProviderContactDays\" and \"triageContactDays\" values are dynamic, and may change independently from one another, so the above calculation is for illustration purposes only.\n\nYou may also wish to present the user-friendly names for the reference data, for example when viewing the referral using [[HYPERLINK_A005]] and [[HYPERLINK_A038]].\n\nDocumentation for other endpoints will reference this endpoint, where specific reference data is required.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request | Response |\n| --------------------------------------------------------- | ------------------------------------------------------- | ----------------------------------------- |\n| Retrieve speciality reference data | `codeSystemType`=`SPECIALTY` | Specialty details |\n| Retrieve clinic type reference data | `codeSystemType`=`CLINIC-TYPE` | Clinic type details |\n| Retrieve appointment cancellation reason reference data | `codeSystemType`=`APPOINTMENT-CANCELLATION-REASON` | Appointment reason type details |\n| Retrieve referral cancellation reason reference data | `codeSystemType`=`REFERRAL-CANCELLATION-REASON` | ReferralRequest reason type details |\n| Retrieve appointment non-attendance reason reference data | `codeSystemType`=`APPOINTMENT-NON-ATTENDANCE-REASON` | Appointment non-attendance reason details |\n| Retrieve priority reference data | `codeSystemType`=`PRIORITY` | Priority details |\n", - "summary": "Retrieve reference data (A004, FHIR STU3)", - "operationId": "a004-retrieve-reference-data", - "tags": [ - "Refer patient", - "Request advice" - ], - "parameters": [ - { - "name": "codeSystemType", - "in": "path", - "description": "The requested code system\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "SPECIALTY", - "APPOINTMENT-CANCELLATION-REASON", - "CLINIC-TYPE", - "REFERRAL-CANCELLATION-REASON", - "APPOINTMENT-NON-ATTENDANCE-REASON", - "PRIORITY" - ], - "example": "SPECIALTY" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "e-RS Reference Data", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "url", - "name", - "status", - "date", - "description", - "content", - "property", - "concept" - ], - "properties": { - "id": { - "title": "Identifier of this code system", - "type": "string", - "enum": [ - "SPECIALTY", - "APPOINTMENT-CANCELLATION-REASON", - "CLINIC-TYPE", - "REFERRAL-CANCELLATION-REASON", - "APPOINTMENT-NON-ATTENDANCE-REASON", - "PRIORITY" - ], - "example": "SPECIALTY" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/StructureDefinition/shareablecodesystem", - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Specialty-CodeSystem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Specialty-CodeSystem-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "CodeSystem" - ], - "example": "CodeSystem" - }, - "url": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "name": { - "title": "Description of the code system", - "type": "string", - "enum": [ - "e-RS Appointment Cancellation Reason", - "e-RS Specialty", - "e-RS Clinic Type", - "e-RS ReferralRequest Cancellation Reason", - "e-RS Appointment Non-attendance Reason", - "e-RS Priority" - ], - "example": "e-RS Specialty" - }, - "status": { - "type": "string", - "enum": [ - "active" - ], - "example": "active" - }, - "date": { - "type": "string", - "format": "date-time" - }, - "publisher": { - "type": "string", - "enum": [ - "e-Referral Service" - ], - "example": "e-Referral Service" - }, - "description": { - "type": "string", - "example": "e-RS Specialty" - }, - "copyright": { - "type": "string", - "example": "Copyright (c) 2016 HL7 UK" - }, - "content": { - "type": "string", - "enum": [ - "complete" - ], - "example": "complete" - }, - "property": { - "title": "Code System Properties", - "description": "\nSome properties are only returned for certain code systems\n \n| Property | Code System |\n| -----------------------------------------| ------------------------------------------------------------- |\n| EffectiveFrom | All Code Systems |\n| EffectiveTo | All Code Systems |\n| Specialty | CLINIC-TYPE |\n| AppointmentBookingCancellationReasonType | APPOINTMENT-CANCELLATION-REASON |\n| WillCancelWholeRequest | APPOINTMENT-CANCELLATION-REASON |\n| Usage | APPOINTMENT-CANCELLATION-REASON |\n| CommentIsMandatory | APPOINTMENT-CANCELLATION-REASON / REFERRAL-CANCELLATION-REASON |\n| BusinessFunction | APPOINTMENT-CANCELLATION-REASON / REFERRAL-CANCELLATION-REASON |\n| AppointmentRequestCancellationReasonType | REFERRAL-CANCELLATION-REASON |\n| CanCancelAppointment | REFERRAL-CANCELLATION-REASON |\n| ReferrerUsage | REFERRAL-CANCELLATION-REASON |\n| DeferToProviderContactDays | PRIORITY |\n| TriageContactDays | PRIORITY |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "Effective from date", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "effectiveFrom" - ], - "example": "effectiveFrom" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveFrom" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveFrom" - }, - "type": { - "type": "string", - "enum": [ - "dateTime" - ], - "example": "dateTime" - } - } - }, - { - "title": "Effective to date", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "effectiveTo" - ], - "example": "effectiveTo" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveTo" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#effectiveTo" - }, - "type": { - "type": "string", - "enum": [ - "dateTime" - ], - "example": "dateTime" - } - } - }, - { - "title": "Specialty", - "description": "This will only be returned when codeSystemType is CLINIC-TYPE", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#specialty" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#specialty" - }, - "type": { - "type": "string", - "enum": [ - "Coding" - ], - "example": "Coding" - } - } - }, - { - "title": "Appointment Booking Cancellation Reason Type", - "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "appointmentBookingCancellationReasonType" - ], - "example": "appointmentBookingCancellationReasonType" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentBookingCancellationReasonType" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentBookingCancellationReasonType" - }, - "type": { - "type": "string", - "enum": [ - "Coding" - ], - "example": "Coding" - } - } - }, - { - "title": "Will Cancel Whole Request", - "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", - "type": "object", - "deprecated": true, - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "willCancelWholeRequest" - ], - "example": "willCancelWholeRequest" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#willCancelWholeRequest" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#willCancelWholeRequest" - }, - "type": { - "type": "string", - "enum": [ - "boolean" - ], - "example": "boolean" - } - } - }, - { - "title": "Usage", - "description": "Details how the current code system should be used", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "usage" - ], - "example": "usage" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#usage" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#usage" - }, - "type": { - "type": "string", - "enum": [ - "Coding" - ], - "example": "Coding" - } - } - }, - { - "title": "Comment Is Mandatory", - "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON or REFERRAL-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "commentIsMandatory" - ], - "example": "commentIsMandatory" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#commentIsMandatory" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#commentIsMandatory" - }, - "type": { - "type": "string", - "enum": [ - "boolean" - ], - "example": "boolean" - } - } - }, - { - "title": "BusinessFunction", - "description": "Details which Business functions are able to use the current code system", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "businessFunction" - ], - "example": "businessFunction" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#businessFunction" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#businessFunction" - }, - "type": { - "type": "string", - "enum": [ - "Coding" - ], - "example": "Coding" - } - } - }, - { - "title": "Appointment Request Cancellation Reason Type", - "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "appointmentRequestCancellationReasonType" - ], - "example": "appointmentRequestCancellationReasonType" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentRequestCancellationReasonType" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#appointmentRequestCancellationReasonType" - }, - "type": { - "type": "string", - "enum": [ - "Coding" - ], - "example": "Coding" - } - } - }, - { - "title": "CanCancelAppointment", - "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "canCancelAppointment" - ], - "example": "canCancelAppointment" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#canCancelAppointment" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#canCancelAppointment" - }, - "type": { - "type": "string", - "enum": [ - "boolean" - ], - "example": "boolean" - } - } - }, - { - "title": "ReferrerUsage", - "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "referrerUsage" - ], - "example": "referrerUsage" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#referrerUsage" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#referrerUsage" - }, - "type": { - "type": "string", - "enum": [ - "Coding" - ], - "example": "Coding" - } - } - }, - { - "title": "Defer to Provider Contact Days", - "description": "This will only be returned when codeSystemType is PRIORITY", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "deferToProviderContactDays" - ], - "example": "deferToProviderContactDays" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#deferToProviderContactDays" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#deferToProviderContactDays" - }, - "type": { - "type": "string", - "enum": [ - "integer" - ], - "example": "integer" - } - } - }, - { - "title": "Triage Contact Days", - "description": "This will only be returned when codeSystemType is PRIORITY", - "type": "object", - "required": [ - "code", - "uri", - "type" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "triageContactDays" - ], - "example": "triageContactDays" - }, - "uri": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#triageContactDays" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Concept-Properties-1#triageContactDays" - }, - "type": { - "type": "string", - "enum": [ - "integer" - ], - "example": "integer" - } - } - } - ] - } - }, - "concept": { - "title": "Details of the code system", - "type": "array", - "items": { - "type": "object", - "required": [ - "code", - "display", - "property" - ], - "properties": { - "extension": { - "title": "Effective Date Range Extensions", - "type": "array", - "nullable": true, - "items": { - "anyOf": [ - { - "title": "Extension-eRS-EffectivefromDate", - "description": "Extension to supply the effective From Date, this will only be returned for specialty", - "type": "object", - "required": [ - "url", - "valueDate" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivefromDate-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivefromDate-1" - }, - "valueDate": { - "type": "string", - "format": "date" - } - } - }, - { - "title": "Extension-eRS-EffectivetoDate", - "description": "Extension to supply the effective To Date, this will only be returned for specialty", - "type": "object", - "required": [ - "url", - "valueDate" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivetoDate-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-EffectivetoDate-1" - }, - "valueDate": { - "type": "string", - "format": "date" - } - } - } - ] - } - }, - "code": { - "title": "Value of the code system", - "description": "\n| Code System | Example Value |\n| ------------------------------------- | ----------------------------- |\n| Specialty | UROLOGY |\n| Clinic Type | GENERAL_UROLOGY |\n| Appointment Cancellation Reason | SERVICE_INAPPROPRIATE |\n| Referral Cancellation Reason | INTEND_PRIVATE |\n| Appointment Non-attendance Reason | PATIENT_ILL |\n| Priority | ROUTINE |\n", - "type": "string" - }, - "display": { - "title": "Display value of the code system", - "description": "\n| Code System | Example Display Value |\n| ------------------------------------- | ----------------------------------- |\n| Specialty | Urology |\n| Clinic Type | General Urology |\n| Appointment Cancellation Reason | Inappropriate service |\n| Referral Cancellation Reason | Patient will go to a private clinic |\n| Appointment Non-attendance Reason | Patient ill |\n| Priority | Routine |\n", - "type": "string" - }, - "property": { - "description": "\nSome properties are only returned for certain code systems\n\n| Property | Code System |\n| -----------------------------------------| ----------------------------------------------------------- |\n| EffectiveFrom | All Code Systems |\n| EffectiveTo | All Code Systems |\n| Specialty | CLINIC-TYPE |\n| AppointmentBookingCancellationReasonType | APPOINTMENT-CANCELLATION-REASON |\n| WillCancelWholeRequest | APPOINTMENT-CANCELLATION-REASON |\n| Usage | APPOINTMENT-CANCELLATION-REASON |\n| CommentIsMandatory | APPOINTMENT-CANCELLATION-REASON/REFERRAL-CANCELLATION-REASON |\n| businessFunction | APPOINTMENT-CANCELLATION-REASON/REFERRAL-CANCELLATION-REASON |\n| AppointmentRequestCancellationReasonType | REFERRAL-CANCELLATION-REASON |\n| CanCancelAppointment | REFERRAL-CANCELLATION-REASON |\n| RequestCancellationReferrerUsage | REFERRAL-CANCELLATION-REASON |\n| DeferToProviderContactDays | PRIORITY |\n| TriageContactDays | PRIORITY |\n", - "type": "array", - "nullable": true, - "items": { - "anyOf": [ - { - "title": "Will cancel whole request value", - "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", - "type": "object", - "deprecated": true, - "required": [ - "code", - "valueBoolean" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "willCancelWholeRequest" - ] - }, - "valueBoolean": { - "type": "boolean" - } - } - }, - { - "title": "Effective from date", - "type": "object", - "required": [ - "code", - "valueDateTime" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "effectiveFrom" - ] - }, - "valueDateTime": { - "type": "string", - "format": "date-time" - } - } - }, - { - "title": "Effective to date", - "type": "object", - "required": [ - "code", - "valueDateTime" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "effectiveTo" - ] - }, - "valueDateTime": { - "type": "string", - "format": "date-time" - } - } - }, - { - "title": "Specialty value", - "description": "This will only be returned when codeSystemType is CLINIC-TYPE", - "type": "object", - "required": [ - "code", - "valueCoding" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "specialty" - ] - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "Appointment cancellation reason type", - "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "valueCoding" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "appointmentBookingCancellationReasonType" - ] - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentBookingCancellationReasonType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentBookingCancellationReasonType-1" - }, - "code": { - "type": "string", - "example": "PROVIDER_REJECT" - } - } - } - } - }, - { - "title": "AppointmentCancellationUsage", - "description": "This will only be returned when `codeSystemType` is `APPOINTMENT-CANCELLATION-REASON`", - "type": "object", - "required": [ - "code", - "valueCoding" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "usage" - ], - "example": "usage" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentCancellationReasonUsage-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentCancellationReasonUsage-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECT", - "CANCEL" - ], - "example": "REJECT" - } - } - } - } - }, - { - "title": "Comment is mandatory value", - "description": "This will only be returned when codeSystemType is APPOINTMENT-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "valueBoolean" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "commentIsMandatory" - ] - }, - "valueBoolean": { - "type": "boolean" - } - } - }, - { - "title": "BusinessFunction", - "description": "This will only be returned when `codeSystemType` is `APPOINTMENT-CANCELLATION-REASON` or `REFERRAL-CANCELLATION-REASON`", - "type": "object", - "required": [ - "code", - "valueCoding" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "businessFunction" - ], - "example": "businessFunction" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - }, - { - "title": "Appointment request cancellation reason type", - "description": "This will only be returned when codeSystemType is REFERRAL-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "valueCoding" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "appointmentRequestCancellationReasonType" - ] - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentRequestCancellationReasonType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentRequestCancellationReasonType-1" - }, - "code": { - "type": "string", - "example": "PROVIDER" - } - } - } - } - }, - { - "title": "CanCancelAppointment", - "description": "This will only be returned when `codeSystemType` is REFERRAL-CANCELLATION-REASON", - "type": "object", - "required": [ - "code", - "valueBoolean" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "canCancelAppointment" - ], - "example": "canCancelAppointment" - }, - "valueBoolean": { - "type": "boolean" - } - } - }, - { - "title": "RequestCancellationReferrerUsage", - "description": "This will only be returned when `codeSystemType` is `REFERRAL-CANCELLATION-REASON`", - "type": "object", - "required": [ - "code", - "valueCoding" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "referrerUsage" - ], - "example": "referrerUsage" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralRequestCancellationReasonUsage-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralRequestCancellationReasonUsage-1" - }, - "code": { - "type": "string", - "enum": [ - "CANCEL_REFERRAL" - ], - "example": "CANCEL_REFERRAL" - } - } - } - } - }, - { - "title": "Defer to provider contact days", - "description": "This will only be returned when codeSystemType is PRIORITY", - "type": "object", - "required": [ - "code", - "valueInteger" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "deferToProviderContactDays" - ] - }, - "valueInteger": { - "type": "integer", - "example": 10 - } - } - }, - { - "title": "Triage contact days", - "description": "This will only be returned when codeSystemType is PRIORITY", - "type": "object", - "required": [ - "code", - "valueInteger" - ], - "properties": { - "code": { - "type": "string", - "enum": [ - "triageContactDays" - ] - }, - "valueInteger": { - "type": "integer", - "example": 10 - } - } - } - ] - } - } - } - } - } - } - }, - "examples": { - "specialty": { - "summary": "Specialty Reference Data", - "description": "This is example data only and should not be taken as the real reference data. Specialty data may have 'effectiveTo' dates in the past", - "value": { - "$ref": "../../../examples/getCodeSystem/responses/SpecialtyCodeSystem.json" - } - }, - "clinic-type": { - "summary": "Clinic Type Reference Data", - "description": "This is example data only and should not be taken as the real reference data.", - "value": { - "$ref": "../../../examples/getCodeSystem/responses/ClinicTypeCodeSystem.json" - } - }, - "appointment-cancellation-reason-code": { - "summary": "Appointment Cancellation Reason Reference Data", - "description": "This is example data only and should not be taken as the real reference data.", - "value": { - "$ref": "../../../examples/getCodeSystem/responses/AppointmentCancellationReasonCodeSystem.json" - } - }, - "referral-request-cancellation-reason-code": { - "summary": "ReferralRequest Cancellation Reason Reference Data", - "description": "This is example data only and should not be taken as the real reference data.", - "value": { - "$ref": "../../../examples/getCodeSystem/responses/ReferralCancellationReasonCodeSystem.json" - } - }, - "appointment-non-attendance-reason": { - "summary": "Appointment Non-attendance Reason Reference Data", - "description": "This is example data only and should not be taken as the real reference data.", - "value": { - "$ref": "../../../examples/getCodeSystem/responses/AppointmentNonAttendanceReasonCodeSystem.json" - } - }, - "priority": { - "summary": "Priority Reference Data", - "description": "This is example data only and should not be taken as the real reference data.", - "value": { - "$ref": "../../../examples/getCodeSystem/responses/PriorityCodeSystem.json" - } - } - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/$ers.fetchworklist": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to retrieve available worklists of referral requests. \nService Providers can use [[HYPERLINK_A023]] to retrieve available worklists of advice and guidance requests. \nThere are currently no worklists of advice and guidance requests for Referrers.\n\nWorklists provide lists of referral/advice requests that meet certain criteria, \ntypically where a user needs to be aware of something important, or to undertake an action, in order to avoid delays to patient care.\n\n## Referring Organisations\nReferring organisations can currently access the following referral related worklists:\n - The 'Letters Outstanding' worklist contains referrals which require a referral letter to be added.\n - The 'Rejected / Triage Response' worklist contains referrals which have had an appointment rejected or have been returned to the referrer with a response as part of a triage outcome.\n - The 'Assessment Returned / Cancelled / DNA' worklist contains referrals which have a clinical assessment outcome of 'advise referrer' recorded, or referrals which have been cancelled by someone outside the initial referring organisation, or referrals where the patient did not attend the appointment booking and the provider has returned the referral back to the referrer for action.\n - The 'Awaiting Booking' worklist contains referrals for which an appointment booking could be made but they do not currently have an appointment booking. This includes referrals that are currently awaiting triage, deferred to provider, or have had their appointment booking cancelled.\n\nFilters can be used in requests for service provider organisation worklists, however, filters cannot be used in requests for referring organisation worklists.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint and retrieve the referring organisation worklists, you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `REFERRING_ADMIN`\n\n### Use case\nAs an authenticated user\n\nI need to retrieve a referral worklist for my referring organisation\n\nSo that I can determine which referrals I need to take further action on\n\n### Related endpoints\nTo retrieve pertinent details relating to a referral:\n - Use [[HYPERLINK_A005]] to retrieve the details of the referral\n - Use [[HYPERLINK_A006]] to retrieve the clinical attachments for a referral\n - Use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for a referral\n\nYou can use [[HYPERLINK_A029]] to determine what endpoints an authenticated user is permitted to use for a referral in it's current state.\n\n## Service Providing Organisations\nService provider organisations can currently access the following referral related worklists:\n - 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.\n - 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). \n The referrals need to be reviewed and if appropriate booked into a service at the service provider organisation.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nSupported Worklists:\n- Referrals for Review\n- Appointment Slot Issues\n\nThe Service filter is mandatory when using this security pattern.\n\nThis endpoint must only be used to retrieve the worklist for a given service up to two times per day. If this does not meet your requirements, please [[HYPERLINK_CONTACT_US]] to discuss your use case.\n\nIf a worklist response exceeds 10MB, a successful response will not be returned. This is due to the size limitation on the APIM platform.\n\n### User-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nSupported Worklists:\n - Referrals for Review\n - Appointment Slot Issues\n\nIf a worklist response exceeds 10MB, a successful response will not be returned. This is due to the size limitation on the APIM platform.\n\n### Use case\nAs an authenticated user\n\nI need to retrieve a referral worklist for my service providing organisation\n\nSo that I can determine which referrals I need to take further action on\n\n### Related endpoints\n\nTo retrieve pertinent details relating to a referral:\n - Use [[HYPERLINK_A005]] to retrieve the details of the referral\n - Use [[HYPERLINK_A006]] to retrieve the clinical attachments for a referral\n - Use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for a referral\n\nFor service providing organisations reviewing booked referrals on the 'Referrals for review' worklist:\n - Use [[HYPERLINK_A013]] to accept a referral into a bookable service\n - Use [[HYPERLINK_A014]] to reject a referral from a bookable service\n - Use [[HYPERLINK_A022]] to request an admin team to rebook or redirect a referral\n\nFor service providing organisations reviewing triage (RAS) referrals on the 'Referrals for review' worklist:\n - Use [[HYPERLINK_A028]] to record the triage outcome based on the available clinical information and attachments\n\nFor service providing organisations reviewing referrals that have been deferred to provider on the 'Appointment slot issues' worklist:\n - Use [[HYPERLINK_A028]] to record the triage outcome based on the available clinical information and attachments\n", - "summary": "Retrieve referral worklist (A008, FHIR STU3)", - "operationId": "a008-retrieve-worklist", - "tags": [ - "Retrieve clinical information", - "Review referral requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-FetchWorklist-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `listType` | `1..1` | |\n| `service` | `0..1` | Mandatory for the application-restricted security pattern |\n| `specialtyAssignedIndicator` | `0..1` | |\n| `specialty` | `0..1` | | \n| `location` | `0..1` | | \n| `clinicianAssignedIndicator` | `0..1` | | \n| `clinician` | `0..1` | | \n", - "items": { - "anyOf": [ - { - "title": "listType", - "description": "Indicates the type of list requested", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "listType" - ], - "example": "listType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| -------------------------------- | ----------- | -------------------------------------- |\n| `eRS-ReferralListSelector` | `0..1` | |\n| `eRS-CommunicationListSelector` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-ReferralListSelector", - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRALS_FOR_REVIEW", - "APPOINTMENT_SLOT_ISSUES", - "REJECTED_TRIAGE_RESPONSE", - "ASSESSMENT_RETURNED_CANCELLED_DNA", - "AWAITING_BOOKING", - "LETTERS_OUTSTANDING" - ], - "example": "REFERRALS_FOR_REVIEW" - } - } - }, - { - "title": "eRS-CommunicationListSelector", - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVICE_AND_GUIDANCE_REQUESTS" - ], - "example": "ADVICE_AND_GUIDANCE_REQUESTS" - } - } - } - ] - } - } - } - } - } - }, - { - "title": "service", - "description": "The service identifier", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - }, - { - "title": "specialtyAssignedIndicator", - "description": "Indicates whether filtering on Specialty is required or not\n", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialtyAssignedIndicator" - ], - "example": "specialtyAssignedIndicator" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - }, - "code": { - "type": "string", - "enum": [ - "ASSIGNED", - "NOT_ASSIGNED" - ], - "example": "NOT_ASSIGNED" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "location", - "description": "The service location identifier", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "location" - ], - "example": "location" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "clinicianAssignedIndicator", - "description": "Indicates whether filtering on Clinician is required or not\n", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicianAssignedIndicator" - ], - "example": "clinicianAssignedIndicator" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - }, - "code": { - "type": "string", - "enum": [ - "ASSIGNED", - "NOT_ASSIGNED" - ], - "example": "NOT_ASSIGNED" - } - } - } - } - } - } - } - }, - { - "title": "clinician", - "description": "The clinician assigned to the Referral Request. If present, the 'clinicianAssignedIndicator' parameter must be set to 'Assigned'", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinician" - ], - "example": "clinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "referrals-for-review": { - "summary": "Referrals for review", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/MinimalReferralsForReview.json" - } - }, - "appointment-slot-issues": { - "summary": "Appointment slot issues", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/MinimalAppointmentSlotIssues.json" - } - }, - "filtered-by-specialty": { - "summary": "Filter by specialty", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/FilteringBySpecialty.json" - } - }, - "filtered-by-clinician": { - "summary": "Filter by clinician", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/FilteringByClinician.json" - } - }, - "filtered-by-service": { - "summary": "Filter by service", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/FilteringByService.json" - } - }, - "rejected-triage-responses": { - "summary": "Rejected Triage Responses", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/MinimalRejectedTriageResponse.json" - } - }, - "assessment-returned-cancelled-dna": { - "summary": "Assessment Returned Cancelled DNA", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/MinimalAssessmentReturnedCancelledDna.json" - } - }, - "awaiting-booking": { - "summary": "Awaiting Booking", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/MinimalAwaitingBooking.json" - } - }, - "letters-outstanding": { - "summary": "Letters Outstanding", - "value": { - "$ref": "../../examples/retrieveWorklist/requests/MinimalLettersOutstanding.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "The response body contains the list of referrals (if any) that match the search criteria provided", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-FetchWorklist-List", - "description": "A list of referrals representing the available worklist items", - "type": "object", - "required": [ - "meta", - "resourceType", - "status", - "mode" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------------------------------------------- |\n| `Practitioner` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n| `Patient` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n", - "items": { - "anyOf": [ - { - "title": "Practitioner", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "Practitioner-021600556514" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Practitioner" - ], - "example": "Practitioner" - }, - "identifier": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - }, - { - "title": "Patient", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "Patient-9912003888" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Patient" - ], - "example": "Patient" - }, - "identifier": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with referral details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070002" - } - } - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ----------------------------------------------------------- | ----------- | ------------------------------------------------------------- |\n| `Extension-eRS-ReferralsforReview-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AppointmentSlotIssues-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested | \n| `Extension-eRS-AdviceAndGuidanceRequests-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-RejectedTriageResponse-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AwaitingBooking-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-LettersOutstanding-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralsforReview-WorkListItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `requestContextStatus` | `1..1` | |\n| `clinicalInfoFirstSubmitted` | `0..1` | |\n| `clinicalInfoLastUpdated` | `0..1` | |\n| `appointmentStart` | `0..1` | |\n| `allocatedClinician` | `0..1` | |\n| `service` | `1..1` | |\n| `referralRequestVersion` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#Patient-9462979626" - } - } - } - } - }, - { - "title": "namedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#Practitioner-021600556514" - } - } - } - } - }, - { - "title": "eReferralPathwayStart", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "eReferralPathwayStart" - ], - "example": "eReferralPathwayStart" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "clinicalInfoPrinted", - "type": "object", - "required": [ - "url", - "valueBoolean" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoPrinted" - ], - "example": "clinicalInfoPrinted" - }, - "valueBoolean": { - "type": "boolean", - "example": false - } - } - }, - { - "title": "requestContextStatus", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "requestContextStatus" - ], - "example": "requestContextStatus" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "LETTER_CHANGED", - "PRIORITY_CHANGED", - "PRIORITY_AND_LETTER_CHANGED", - "NEVER_REVIEWED" - ], - "example": "NEVER_REVIEWED" - }, - "display": { - "type": "string", - "example": "Never Reviewed" - } - } - } - } - } - } - } - }, - { - "title": "clinicalInfoFirstSubmitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoFirstSubmitted" - ], - "example": "clinicalInfoFirstSubmitted" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "clinicalInfoLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoLastUpdated" - ], - "example": "clinicalInfoLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-03T10:44:42.764Z" - } - } - }, - { - "title": "referralType", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralType" - ], - "example": "referralType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" - }, - "code": { - "type": "string", - "enum": [ - "APPOINTMENT", - "TRIAGE_DEFERRAL" - ], - "example": "TRIAGE_DEFERRAL" - } - } - } - } - } - } - } - }, - { - "title": "appointmentStart", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "appointmentStart" - ], - "example": "appointmentStart" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-02T14:15:00.000Z" - } - } - }, - { - "title": "allocatedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "allocatedClinician" - ], - "example": "allocatedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#Practitioner-021600556514" - } - } - } - } - }, - { - "title": "service", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Service Name" - } - } - } - } - }, - { - "title": "referralRequestVersion", - "type": "object", - "required": [ - "url", - "valueInteger" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralRequestVersion" - ], - "example": "referralRequestVersion" - }, - "valueInteger": { - "type": "integer", - "example": 0 - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AppointmentSlotIssues-WorkListItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `ubrnReceived` | `0..1` | |\n| `patientContactExpected` | `0..1` | |\n| `clinicalInformationStatus` | `0..1` | |\n| `reason` | `0..1` | |\n| `lastContact` | `0..1` | |\n| `service` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "namedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "eReferralPathwayStart", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "eReferralPathwayStart" - ], - "example": "eReferralPathwayStart" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "clinicalInfoPrinted", - "type": "object", - "required": [ - "url", - "valueBoolean" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoPrinted" - ], - "example": "clinicalInfoPrinted" - }, - "valueBoolean": { - "type": "boolean", - "example": false - } - } - }, - { - "title": "ubrnReceived", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "ubrnReceived" - ], - "example": "ubrnReceived" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "patientContactExpected", - "type": "object", - "required": [ - "url", - "valueDate" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patientContactExpected" - ], - "example": "patientContactExpected" - }, - "valueDate": { - "type": "string", - "format": "date", - "example": "2021-09-07" - } - } - }, - { - "title": "clinicalInformationStatus", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInformationStatus" - ], - "example": "clinicalInformationStatus" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PRESENT", - "NOT_APPLICABLE", - "NOT_DUE", - "OVERDUE" - ], - "example": "NOT_DUE" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - } - } - } - } - } - }, - { - "title": "lastContact", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "lastContact" - ], - "example": "lastContact" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "service", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Service Name" - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AdviceAndGuidanceRequests-WorkListItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `category` | `1..1` | |\n| `adviceFirstRequested` | `1..1` | |\n| `adviceLastUpdated` | `1..1` | |\n| `referrer` | `1..1` | |\n| `service` | `1..1` | |\n| `clinicType` | `0..1` | |\n| `communicationRequestVersion` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "namedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "category", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "category" - ], - "example": "category" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_RESPONSE_REQUIRED", - "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", - "REFERRER_TO_REVIEW_RESPONSE", - "CONVERSATION_ENDED_CANCELLED", - "CONVERSATION_ENDED_CLOSED", - "ADVICE_CONVERTED" - ], - "example": "PROVIDER_RESPONSE_REQUIRED" - } - } - } - } - } - } - } - }, - { - "title": "adviceFirstRequested", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "adviceFirstRequested" - ], - "example": "adviceFirstRequested" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "adviceLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "adviceLastUpdated" - ], - "example": "adviceLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "adviceLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "adviceLastUpdated" - ], - "example": "adviceLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "service", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Service Name" - } - } - } - } - }, - { - "title": "clinicType", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/CLINIC-TYPE" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - } - } - } - }, - { - "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": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Rejected/TriageRequest worklist, only included if `status` is `TRIAGE_RESPONSE` |\n", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "referralLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLastUpdated" - ], - "example": "referralLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "status", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "status" - ], - "example": "status" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "ASSESSMENT_RESULT", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "NOT_BOOKED", - "BOOKED", - "AWAITING_TRIAGE", - "DEFERRED_TO_PROVIDER", - "APP_CANCELLED_BY_PROVIDER", - "APP_CANCELLED_BY_PATIENT", - "TRIAGED_PROVIDER_TO_ACTION", - "TRIAGE_RESPONSE" - ], - "example": "REJECTED" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Assessment result", - "Cancelled referral", - "Did not attend", - "Not booked", - "Booked", - "Awaiting triage", - "Deferred to provider", - "Appointment cancelled by provider", - "Appointment cancelled by patient", - "Triaged - provider to action", - "Triage Response" - ], - "example": "Rejected" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - ], - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "FURTHER_INFORMATION_REQUIRED" - }, - "display": { - "type": "string", - "example": "Further information required" - } - } - } - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" - }, - "extension": { - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Assessment Returned / Cancelled / DNA worklist, only included if `status` is `CANCELLED_REFERRAL` |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "referralLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLastUpdated" - ], - "example": "referralLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "status", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "status" - ], - "example": "status" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "ASSESSMENT_RESULT", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "NOT_BOOKED", - "BOOKED", - "AWAITING_TRIAGE", - "DEFERRED_TO_PROVIDER", - "APP_CANCELLED_BY_PROVIDER", - "APP_CANCELLED_BY_PATIENT", - "TRIAGED_PROVIDER_TO_ACTION", - "TRIAGE_RESPONSE" - ], - "example": "REJECTED" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Assessment result", - "Cancelled referral", - "Did not attend", - "Not booked", - "Booked", - "Awaiting triage", - "Deferred to provider", - "Appointment cancelled by provider", - "Appointment cancelled by patient", - "Triaged - provider to action", - "Triage Response" - ], - "example": "Rejected" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" - ], - "example": "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "INTEND_PRIVATE" - }, - "display": { - "type": "string", - "example": "Patient will go to a private clinic" - } - } - } - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AwaitingBooking-WorklistItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" - }, - "extension": { - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Awaiting Booking worklist, only included if `status` is `APPOINTMENT_CANCELLED_BY_PROVIDER` or `APPOINTMENT_CANCELLED_BY_PATIENT` |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "referralLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLastUpdated" - ], - "example": "referralLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "status", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "status" - ], - "example": "status" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "ASSESSMENT_RESULT", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "NOT_BOOKED", - "BOOKED", - "AWAITING_TRIAGE", - "DEFERRED_TO_PROVIDER", - "APP_CANCELLED_BY_PROVIDER", - "APP_CANCELLED_BY_PATIENT", - "TRIAGED_PROVIDER_TO_ACTION", - "TRIAGE_RESPONSE" - ], - "example": "REJECTED" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Assessment result", - "Cancelled referral", - "Did not attend", - "Not booked", - "Booked", - "Awaiting triage", - "Deferred to provider", - "Appointment cancelled by provider", - "Appointment cancelled by patient", - "Triaged - provider to action", - "Triage Response" - ], - "example": "Rejected" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - ], - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_APPOINTMENT_CLASH" - }, - "display": { - "type": "string", - "example": "Patient - Clashes with another appointment" - } - } - } - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-LettersOutstanding-WorklistItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" - }, - "extension": { - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `letterDue` | `1..1` | The `date` a referral letter is due for the `ReferralRequest` |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "letterDue", - "type": "object", - "required": [ - "url", - "valueDate" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "letterDue" - ], - "example": "letterDue" - }, - "valueDate": { - "type": "string", - "format": "date", - "example": "2021-11-24" - } - } - } - ] - } - } - } - } - ] - } - } - } - } - } - } - }, - "examples": { - "referrals-for-review": { - "summary": "Referrals for Review", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/ReferralsForReview.json" - } - }, - "appointment-slot-issues": { - "summary": "Appointment Slot Issues", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/AppointmentSlotIssues.json" - } - }, - "filtered-by-specialty": { - "summary": "Filtered by specialty", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/FilteredBySpecialty.json" - } - }, - "filtered-by-clinician": { - "summary": "Filtered by clinician", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/FilteredByClinician.json" - } - }, - "filtered-by-service": { - "summary": "Filtered by service", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/FilteredByService.json" - } - }, - "rejected-triage-responses": { - "summary": "Rejected Triage / Response", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/RejectedTriageResponse.json" - } - }, - "assessment-returned-cancelled-dna": { - "summary": "Assessment Returned / Cancelled / DNA", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/AssessmentReturnedCancelledDna.json" - } - }, - "awaiting-booking": { - "summary": "Awaiting Booking", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/AwaitingBooking.json" - } - }, - "letters-outstanding": { - "summary": "Letters Outstanding", - "value": { - "$ref": "../../../examples/retrieveWorklist/responses/LettersOutstanding.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request or service. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve details of a referral. This includes references to clinical attachments, related referrals and other important data.\n\nDuring the lifecycle of a referral, the state of the referral may change multiple times. To help with understanding the state of a referral, we provide an \"at a glance\" summary of the referral as detailed below:\n\n| Code returned via https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1 | Description |\n| ------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |\n| `APPT_CANCELLED_BY_PATIENT` | The referral's most recent appointment was cancelled at the request of, or directly by, a patient |\n| `APPT_CANCELLED_BY_PROVIDER` | The referral's most recent appointment was cancelled by the service provider |\n| `ASSESSMENT_RESULT` | A service provider has reviewed and drafted, or submitted a clinical assessment for the referral |\n| `AWAITING_TRIAGE` | The triage referral is currently pending review with a service provider |\n| `BOOKED` | This referral's appointment indicates a date and time with a service |\n| `CANCELLED_REFERRAL` | The referral has been cancelled and cannot be progressed any further |\n| `DEFERRED_TO_PROVIDER` | The service provider will arrange the patient's appointment |\n| `DID_NOT_ATTEND` | The patient did not attend their last appointment |\n| `NOT_BOOKED` | The referral is currently not booked, there is currently no planned patient encounter |\n| `REJECTED` | The referral was rejected by a provider at their service |\n| `TRIAGE_RESPONSE` | A service has passed the referral back to the referrer, with advice |\n| `TRIAGED_PROVIDER_TO_ACTION` | The service provider has recorded a review decision, with the intention of processing this referral |\n\nSome referral states may also have a `reason` and some reasons may also have a `comment`. These are described below:\n\n## Reason\n- The reason is always connected to the current state. This means the reason is likely to change each time the state changes. You cannot currently retrieve previous versions of a referral.\n- This reason may have been selected by a clinician or automatically applied by the e-RS system at the time the state was persisted.\n- A reason can be dynamic reference data, from any of the following sets of reference data: `APPOINTMENT-CANCELLATION-REASON`, `REFERRAL-CANCELLATION-REASON`, `APPOINTMENT-NON-ATTENDANCE-REASON`. These are retrievable from [[HYPERLINK_A004]].\n- A reason may be static reference data.\n\n## Comments\n- The comment is always connected to the current reason, and state. This means the comment is likely to change as the state changes.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user or application and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to retrieve details of a referral.\n\n## Important notes\n### Attachment availability\n\n In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A005]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|-------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE | The file is available for download. |\n| PENDING | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again |\n| THREATS FOUND | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n### Receiving an e-Referral Pathway Start Date\n \nThe e-Referral Pathway Start Date is a derived value of when the Referral To Treatment (RTT) clock starts. Find out how e-RS derives the pathway start date [[HYPERLINK_PATHWAY_START]].\n\nIf a referral was created with an alternate pathway start date, then this will be available in the referral request response.\n\nService providers must always ensure the correct start date is recorded in line with [[HYPERLINK_RTT_RULES]].\n\n## Use case\n\nAs an authenticated user or application\n\nI want to read details of a referral\n\nSo that I can decide what further action may be needed.\n\n## Related endpoints\n\nYou can retrieve attachments that are associated with the referral using [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]. Attachments can only be retrieved where the eRS-AvailabilityStatus-1 code returned is 'AVAILABLE'\n\nYou can retrieve a clinical information summary for the referral using [[HYPERLINK_A007]]\n\nYou can search for services appropriate to a referral to form a shortlist using [[HYPERLINK_A010]]\n\nIf bookable services are on the shortlist of the referral, you can retrieve appointment slots for a service on the shortlist for a referral using [[HYPERLINK_A015]]\n\nYou can retrieve the patient letter appropriate to the referral using [[HYPERLINK_A019]]\n\nYou can retrieve reference data used in viewing a referral using [[HYPERLINK_A004]]\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ----------------------- |\n| Unbooked `ReferralRequest` | `ubrn`=`000000070000` |\n| `ReferralRequest` booked to directly-bookable service | `ubrn`=`000000070001` |\n| `ReferralRequest` booked to indirectly-bookable service | `ubrn`=`000000070002` |\n| `ReferralRequest` deferred to service provider for booking | `ubrn`=`000000070003` |\n| `ReferralRequest` that was converted from an Advice and Guidance Request | `ubrn`=`000000070004` |\n| `ReferralRequest` with related `ReferralRequest` | `ubrn`=`000000070005` |\n| `ReferralRequest` with additional requirements listed | `ubrn`=`000000070011` |\n| `ReferralRequest` with attachments unavailable to download | `ubrn`=`000000070012` | \n", - "summary": "Retrieve referral request (A005, FHIR STU3)", - "operationId": "a005-retrieve-referral-request", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "unbooked": { - "summary": "Unbooked `ReferralRequest`", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/Unbooked.json" - } - }, - "booked-dbs": { - "summary": "`ReferralRequest` booked to directly-bookable service", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/BookedDBS.json" - } - }, - "booked-ibs": { - "summary": "`ReferralRequest` booked to indirectly-bookable service", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/BookedIBS.json" - } - }, - "deferred-to-provider": { - "summary": "`ReferralRequest` deferred to service provider for booking", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/DeferredToProvider.json" - } - }, - "converted-from-advice-and-guidance": { - "summary": "`ReferralRequest` that was converted from an Advice and Guidance Request", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/ConvertedFromAdviceAndGuidance.json" - } - }, - "with-related-referral": { - "summary": "`ReferralRequest` with related ReferralRequest", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/WithRelatedReferral.json" - } - }, - "with-additional-requirements": { - "summary": "`ReferralRequest` with additional requirements", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/WithAdditionalRequirements.json" - } - }, - "with-unavailable-attachments": { - "summary": "Unbooked `ReferralRequest` with attachments unavailable for download", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/WithUnavailableAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Task": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nThis endpoint allows an authenticated e-RS user to check ahead of performing an action, \nwhether or not the action is permitted. This endpoint performs a search for available and \nsupported actions that can be *currently* performed, by the *current* e-RS user on a *specific* \nreferral. When a permitted action is returned, the e-RS user could immediately attempt to \nperform a permitted action.\n\nYou SHOULD NOT cache the list of available user actions returned because this endpoint \ngives the *current* actions for the *current* e-RS user, for the referral in context and is therefore, \ntransient; a future call for a different e-RS user, referral, or at a different point in time, \nmight result in a different set of actions, leading to potential failure flows.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Application-restricted, unattended access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nSupported action:\n - Record Review Outcome\n - Cancel Referral\n\n### Healthcare worker, user-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou should obtain a `Unique Booking Reference Number` (UBRN) before using this endpoint, as the current UBRN version is required.\n\n## Use case\n\nAs an authenticated user\n\nI want to know what actions I might currently perform on a referral prior to attempting to do so\n\nSo that I can review my options, and do not try to persist a prohibited action\n\n## Important information about using this endpoint\n\nThis endpoint can be used to check permitted actions on a referral. Only a select number of results will be returned for which a corresponding action can be performed via the API. Not all actions are currently supported.\n\nAs a referrer, the actions returned can include:\n - Cancel Directly Booked Appointment \n - Cancel Referral\n - Create Appointment\n - Change Shortlist\n - Change Shortlist and Send for Triage\n\nAs a service provider, the actions returned can include:\n - Record Review Outcome\n - Cancel Referral\n\n## Related endpoints\n\nTo retrieve pertinent details relating to a referral:\n - Use [[HYPERLINK_A005]] to retrieve the details of the referral, UBRN and UBRN version.\n\nBelow is a list of actions that could be returned by calling [[HYPERLINK_A029]]\n - Use [[HYPERLINK_A028]] to record a review outcome based on the available clinical information and attachments.\n - Use [[HYPERLINK_A016]] to Book, or if unable, Defer, an appointment to a specific service on the current shortlist, or to make a triage deferral by sending an appointment to a triage service.\n - Use [[HYPERLINK_A031]] to change the shortlist of bookable services on an existing referral.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| --------------------------------------------------- | ---------------------------------------------------------------------------------------- |\n| No \"action\" is available | `focus`=`ReferralRequest/000000070000/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Record Review Outcome\" is available | `focus`=`ReferralRequest/000000070001/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Create Appointment\" is available | `focus`=`ReferralRequest/000000070002/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Change Shortlist\" is available | `focus`=`ReferralRequest/000000070003/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Change Shortlist and Send for Triage\" is available | `focus`=`ReferralRequest/000000070004/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Cancel Referral\" is available | `focus`=`ReferralRequest/000000070005/_history/6`, `intent`=`proposal`, `status`=`ready` |\n| \"Cancel Directly Booked Appointment\" is available | `focus`=`ReferralRequest/000000070006/_history/6`, `intent`=`proposal`, `status`=`ready` |\n", - "summary": "Available actions for user (A029, FHIR STU3)", - "operationId": "a029-available-actions-for-user-list", - "tags": [ - "Change appointment", - "Manage referral", - "Review referral requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "query", - "name": "focus", - "description": "The component describing the ReferralRequest for which the task list is requested for.\n\nPattern:\n\n`ReferralRequest/{ubrn}/_history/{version}`\n\n - The `ubrn` represents the unique booking reference number of the referral request\n - The `version` is the version of the referral request (only the most current version will be accepted)\n", - "required": true, - "schema": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/6" - } - }, - { - "in": "query", - "name": "intent", - "description": "Value must be set to `proposal`\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "proposal" - ], - "example": "proposal" - } - }, - { - "in": "query", - "name": "status", - "description": "The status of the `task`, value must be set to `ready`\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "ready" - ], - "example": "ready" - } - } - ], - "responses": { - "200": { - "description": "Bundle containing list of available tasks", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "Bundle resource containing tasks", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "type", - "link", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "604dc1ea-986c-45ec-b36c-cf9d2fabc5c0" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated", - "profile" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" - ], - "example": "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Bundle" - ], - "example": "Bundle" - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "link": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/STU3/Task?focus=ReferralRequest/000000070000/_history/6&intent=proposal&status=ready" - } - } - } - }, - "entry": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ----------------------- | ----------- | --------------------------------------------------- |\n| `CareConnect-Task` | `0..*` | |\n", - "items": { - "title": "CareConnect-Task", - "description": "CareConnect-Task details a single `task` (action available for user).\n", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/STU3/Task/ed4dff57-503c-46ef-9084-4045a23f4c2a" - }, - "resource": { - "title": "CareConnect-Task", - "description": "The Task resource represents a specific task to be performed by the user.", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "intent", - "focus" - ], - "properties": { - "id": { - "type": "string", - "example": "ed4dff57-503c-46ef-9084-4045a23f4c2a" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Task-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Task-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Task" - ], - "example": "Task" - }, - "status": { - "type": "string", - "enum": [ - "ready" - ], - "example": "ready" - }, - "intent": { - "type": "string", - "enum": [ - "proposal" - ], - "example": "proposal" - }, - "focus": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/6" - } - } - }, - "code": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "anyOf": [ - { - "title": "AvailableActionsForUser", - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailableActionsForUser-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailableActionsForUser-1" - }, - "code": { - "type": "string", - "enum": [ - "RECORD_REVIEW_OUTCOME", - "CREATE_APPOINTMENT", - "CHANGE_SHORTLIST", - "CHANGE_SHORTLIST_AND_SEND_FOR_TRIAGE", - "CANCEL_REFERRAL", - "CANCEL_DIRECTLY_BOOKED_APPOINTMENT" - ], - "example": "RECORD_REVIEW_OUTCOME" - }, - "display": { - "type": "string", - "enum": [ - "Record Review Outcome", - "Create Appointment", - "Change Shortlist", - "Change Shortlist and Send for Triage", - "Cancel Referral", - "Cancel Directly Booked Appointment" - ], - "example": "Record Review Outcome" - } - } - } - ] - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - } - } - } - } - } - }, - "examples": { - "empty": { - "summary": "Empty", - "value": { - "$ref": "../../../examples/availableActionsForUserList/Empty.json" - } - }, - "with-record-review-outcome": { - "summary": "With Record Review Outcome", - "value": { - "$ref": "../../../examples/availableActionsForUserList/WithRecordReviewOutcome.json" - } - }, - "with-create-appointment": { - "summary": "With Create Appointment", - "value": { - "$ref": "../../../examples/availableActionsForUserList/WithCreateAppointment.json" - } - }, - "with-change-shortlist": { - "summary": "With Change Shortlist", - "value": { - "$ref": "../../../examples/availableActionsForUserList/WithChangeShortlist.json" - } - }, - "with-change-shortlist-and-send-for-triage": { - "summary": "With Change Shortlist and Send for Triage", - "value": { - "$ref": "../../../examples/availableActionsForUserList/WithChangeShortlistAndSendForTriage.json" - } - }, - "with-cancel-referral": { - "summary": "With Cancel Referral", - "value": { - "$ref": "../../../examples/availableActionsForUserList/WithCancelReferral.json" - } - }, - "with-cancel-directly-booked-appointment": { - "summary": "With Cancel Directly Booked Appointment", - "value": { - "$ref": "../../../examples/availableActionsForUserList/WithCancelDBAppointment.json" - } - } - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| MISSING_PARAMETER | Indicates missing mandatory FHIR search parameter. |\n| HISTORY_NOT_SUPPORTED | Only the current version of the UBRN is permissible. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/_history/{version}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to retrieve a specific version of `ReferralRequest`.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nThe pre-requisites for this endpoint are the same as for endpoint [[HYPERLINK_A005]].\n\nNote: e-RS only supports the retrieval of the most recent version of `ReferralRequest`. You cannot retrieve earlier versions.\n\n## Important notes\n### Attachment availability\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A005]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|-------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE | The file is available for download. |\n| PENDING | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again |\n| THREATS FOUND | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n### Receiving an e-Referral Pathway Start Date \n \nThe e-Referral Pathway Start Date is a derived value of when the Referral To Treatment (RTT) clock starts. Find out how e-RS derives the pathway start date [[HYPERLINK_PATHWAY_START]].\n\nIf a referral was created with an alternate pathway start date, then this will be available in the referral request response.\n\nService providers must always ensure the correct start date is recorded in line with [[HYPERLINK_RTT_RULES]].\n\n## Use case\n\nSee [[HYPERLINK_A005]].\n\n## Related endpoints\n\nSee [[HYPERLINK_A005]].\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ------------------------------------- |\n| Unbooked `ReferralRequest` | `ubrn`=`000000070000`, `version`=`5` |\n| `ReferralRequest` booked to directly-bookable service | `ubrn`=`000000070001`, `version`=`5` |\n| `ReferralRequest` booked to indirectly-bookable service | `ubrn`=`000000070002`, `version`=`5` |\n| `ReferralRequest` deferred to service provider for booking | `ubrn`=`000000070003`, `version`=`5` |\n| `ReferralRequest` that was converted from an Advice and Guidance Request | `ubrn`=`000000070004`, `version`=`5` |\n| `ReferralRequest` with related `ReferralRequest` | `ubrn`=`000000070005`, `version`=`5` |\n| `ReferralRequest` with additional requirements listed | `ubrn`=`000000070011`, `version`=`5` |\n| `ReferralRequest` with attachments unavailable to download | `ubrn`=`000000070012`, `version`=`5` | \n", - "summary": "Retrieve referral request (versioned) (A005, FHIR STU3)", - "operationId": "a005-retrieve-referral-request-versioned", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "name": "version", - "in": "path", - "description": "The version of the resource to be retrieved. It must be the latest version of the resource otherwise\n`HISTORY_NOT_SUPPORTED` error will be returned (HTTP 404 Not Found).\n", - "required": true, - "schema": { - "type": "string", - "example": "5" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "unbooked": { - "summary": "Unbooked `ReferralRequest`", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/Unbooked.json" - } - }, - "booked-dbs": { - "summary": "`ReferralRequest` booked to directly-bookable service", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/BookedDBS.json" - } - }, - "booked-ibs": { - "summary": "`ReferralRequest` booked to indirectly-bookable service", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/BookedIBS.json" - } - }, - "deferred-to-provider": { - "summary": "`ReferralRequest` deferred to service provider for booking", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/DeferredToProvider.json" - } - }, - "converted-from-advice-and-guidance": { - "summary": "`ReferralRequest` that was converted from an Advice and Guidance Request", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/ConvertedFromAdviceAndGuidance.json" - } - }, - "with-related-referral": { - "summary": "`ReferralRequest` with related ReferralRequest", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/WithRelatedReferral.json" - } - }, - "with-additional-requirements": { - "summary": "`ReferralRequest` with additional requirements", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/WithAdditionalRequirements.json" - } - }, - "with-unavailable-attachments": { - "summary": "Unbooked `ReferralRequest` with attachments unavailable for download", - "value": { - "$ref": "../../../examples/retrieveReferralRequest/responses/WithUnavailableAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found - Resource not found for ID provided or Resource version does not match version requested." - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Binary/{attachmentLogicalID}": { - "get": { - "deprecated": true, - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n **This endpoint has now been deprecated please use [[HYPERLINK_A042]] instead.**\n\nUse this endpoint to retrieve a file that is attached to a referral or advice request.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n\n## Pre-requisites\n### Authentication\n#### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application.\n\n#### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user or application and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n### Attachment availability\nIn order to use this endpoint, the attachment to be retrieved must be available for download. Attachments are only made available once an uploaded file has been validated and successfully scanned for malware. A request to retrieve an attachment that is not available for download will result in a 422 error being returned. See the Response section for further information.\n\nThe availability status of an attachment can be retrieved via any endpoint that provides details of an attachment in the success response. Details of the availability statuses that may be returned via these endpoints can be found in the specification for [[HYPERLINK_A005]].\n\nPrior to retrieving an attachment, you will need to have retrieved the referral or advice request the attachment is associated with (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example). Referrals and advice requests include resolvable URLs to the files currently attached to them, which can be used with this endpoint to retrieve the attachments themselves.\n\n### Maximum file size\n\n The [[HYPERLINK_A006]] endpoint allows you to retrieve attachments up to a maximum file size of 5MB (5242880 bytes). Attempting to retrieve a file over this limit will lead to a 422 error being returned. See the Response section for further information. Due to this, prior to calling this endpoint, the size of the attachment being retrieved should first be validated so that this error can be avoided.\n\nFiles that are larger than 5MB can be downloaded via the [[HYPERLINK_A042]] endpoint or the e-RS web-based professional application.\n\n## Important notes\n\nA referral pathway in e-RS can be made up of more than one UBRN. \nFor example, a referral is booked and seen in a general knee clinical assessment service (UBRN #1), \nand the service decides to onward refer to a more specialist knee miniscus service (UBRN #2). \nThis would result in two UBRNs for the referral pathway in this example (but there could be more related UBRNs if onward referred multiple times).\n\nAs such, it is important that all clinical information is obtained from across all the related UBRNs referenced in [[HYPERLINK_A005]]. \nYou can do this using the following endpoints:\n\n - [[HYPERLINK_A007]]\n - [[HYPERLINK_A006]]\n\nNote: It is possible that the initial UBRN may be the only one in the referral pathway to have clinical information and/or attachments associated.\n\nThe [[HYPERLINK_A006]] endpoint allows you to retrieve attachments up to a maximum file size of 5MB (5242880 bytes), subject to the attachment being available for download. Attempts to retrieve an attachment that is not available, or exceeds the maximum file size, will lead to a 422 error being returned. See the Response section for further information.\n\n## Use case\n\nAs an authenticated user\n\nI need to retrieve a clinical attachment associated with a referral\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\n\nYou can retrieve a clinical information summary for a referral using [[HYPERLINK_A007]].\n\n## Sandbox test scenarios\n\nThe sandbox for this endpoint is a simple implementation that only supports success cases.\n\nA successful response will always be returned, provided the Binary ID is in a valid format. The Availability Status of a file is not considered in the sandbox and a file will always be available for retrieval.\n\nSuccessful responses will always return the same example PDF file.\n", - "summary": "Retrieve attachment (A006, FHIR STU3) [deprecated]", - "operationId": "a006-retrieve-attachment", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "path", - "name": "attachmentLogicalID", - "description": "Reference to attachment as provided in the output from [[HYPERLINK_A005]]\n", - "required": true, - "schema": { - "type": "string" - }, - "examples": { - "uuid-format": { - "value": "c5d2d200-7613-4a69-9c5f-1bb68e04b8d8", - "summary": "ID of an attachment utilising UUID ID format." - }, - "legacy-format": { - "value": "att-70000-70001", - "summary": "ID of an attachment utilising the legacy ID format." - } - } - } - ], - "responses": { - "200": { - "description": "Response contains the binary stream of the file attachment requested.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Disposition": { - "description": "The description of the type of content provided.\n", - "required": true, - "schema": { - "type": "string", - "example": "attachment; filename=\"000000070000_Appointment_Confirmation_Summary_20210603121353.pdf\"" - } - }, - "Content-Length": { - "description": "The length of the response.\n", - "required": true, - "schema": { - "type": "string", - "example": "3111" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "text/plain", - "text/html", - "application/pdf", - "text/xml", - "text/rtf", - "audio/basic", - "audio/mpeg", - "image/png", - "image/gif", - "image/jpeg", - "image/tiff", - "video/mpeg", - "application/msword", - "application/vnd.openxmlformats-officedocument.wordprocessingml.document", - "application/dicom" - ], - "example": "text/plain" - } - } - }, - "content": { - "text/plain": { - "schema": { - "type": "string", - "format": "binary" - }, - "example": "This is some example text." - }, - "text/html": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/xml": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/rtf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/basic": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/png": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/gif": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/jpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/tiff": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "video/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/msword": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/dicom": { - "schema": { - "type": "string", - "format": "binary" - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| FILE_SIZE_ERROR | The file requested is larger than 5MB (5242880 bytes) so cannot be retrieved via this endpoint. Files larger than 5MB can be downloaded via the [[HYPERLINK_A042]] endpoint or the e-RS web-based professional application. |\n| PENDING | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. |\n| THREATS_FOUND | The file has been quarantined after detecting a threat and cannot be retrieved. Contact the organisation that uploaded the file to resolve the issue and get the information you need. Details of who uploaded the file can be retrieved via any endpoint that provides details of an attachment in the success response (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example) |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved. Contact the organisation that uploaded the file to resolve the issue and get the information you need. Details of who uploaded a file can be retrieved via any endpoint that provides details of an attachment in the success response (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example)
Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS. Note, this indicates that the file size is larger than the system supports as a whole, not the 5MB limit associated with this endpoint
\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/R4/Binary/{id}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve a file that is attached to a referral or advice request.\n\nReferral information can also include:\n - Structured clinical information added by an integrated primary care system\n - Service provider activity\n - Advice and guidance conversation\n\nThis additional clinical information must be retrieved via [[HYPERLINK_A007]]\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted, unattended access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user or application and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n### Attachment availability\nTo use this endpoint, the attachment must be available for download. Attachments are only available after successful validation and malware scans. A request to retrieve an attachment that is not available for download will result in a 400 error. See the Response HTTP 400 section for further information.\n\nThe availability status of an attachment can be retrieved via any endpoint that provides details of an attachment in the success response. Details of the availability statuses that may be returned via these endpoints can be found in the specification for [[HYPERLINK_A005]].\n\nPrior to retrieving an attachment, you will need to have retrieved the referral or advice request the attachment is associated with (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example). Referrals and advice requests include resolvable URLs to the files currently attached to them, which can be used with this endpoint to retrieve the attachments themselves.\n\n## Support for a temporary redirect\nThis endpoint makes use of a HTTP 307 temporary redirect. It redirects the caller to a temporary location from which the file contents can be downloaded directly.\n\nThe temporary location is only valid for a short period of time and should be used immediately. \n\nCallers of this endpoint must ensure they:\n - follow this redirect to retrieve the file\n - do not cache the temporary location\n - generate a new redirect each time the file is downloaded\n\nSee the Response HTTP 307 section for further information.\n\n## Important notes\nA referral pathway in e-RS can be made up of more than one UBRN. For example: a referral is booked and seen in a general knee clinical assessment service (UBRN #1), and the service decides to onward refer to a more specialist knee meniscus service (UBRN #2). This would result in two UBRNs for the referral pathway. There may be additional related UBRNs if there are multiple onward referrals.\n\nAs such, it is important that all clinical information is obtained from across all the related UBRNs referenced in [[HYPERLINK_A005]]. You can do this using the following endpoints:\n - [[HYPERLINK_A006]]\n - [[HYPERLINK_A007]]\n\nNote: It is possible that the initial UBRN may be the only one in the referral pathway to have clinical information and/or attachments associated.\n\n## Use case \nAs an authenticated user\n\nI need to retrieve a clinical attachment associated with a referral or advice request\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\n - [[HYPERLINK_A005]] to retrieve details of a referral. This includes references to clinical attachments, related referrals and other important data.\n - [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request. This endpoint provides important contextual information about the advice and guidance request (e.g. the service/specialty to which advice has been requested, etc).\n - [[HYPERLINK_A025]] to retrieve the advice and guidance conversation between the referring organisation and service providing organisation.\n - [[HYPERLINK_A007]] to generate a PDF file that summarises clinical information for a referral.\n\n## Sandbox test scenarios\nThe sandbox for this endpoint is a simple implementation that only supports success cases.\n\nInline with the behaviour described in \"Support for a temporary redirect\", the sandbox will return a HTTP 307 temporary redirect. For simplicity, the temporary location will be static and never expire, unlike the live environment.\n\nA successful response will always be returned, provided the Binary ID is in a valid format. The Availability Status of a file is not considered in the sandbox and a file will always be available for retrieval.\n\nSuccessful responses will always return the same example PDF file.\n", - "summary": "Retrieve attachment (A042, FHIR R4)", - "operationId": "a042-retrieve-attachment", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "path", - "name": "id", - "description": "The identifier for the binary.\n", - "required": true, - "schema": { - "type": "string" - }, - "examples": { - "uuid-format": { - "value": "c5d2d200-7613-4a69-9c5f-1bb68e04b8d8", - "summary": "A binary ID utilising the UUID ID format." - }, - "legacy-format": { - "value": "att-70000-70001", - "summary": "A binary ID utilising the legacy ID format." - } - } - } - ], - "responses": { - "307": { - "description": "Response redirects the user agent to a location (via the Location header) in the object store from which the attachment can be downloaded from.", - "headers": { - "x-correlation-id": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "x-request-id": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Location": { - "description": "The attachment location in the object store.", - "required": true, - "schema": { - "type": "string", - "format": "uri" - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| REC_BAD_REQUEST | invalid | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The request could not be processed due to an error. This could be due to either an error with the request or the state of the resource requested. See the diagnostics field for further information. |\n", - "headers": { - "x-correlation-id": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "x-request-id": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "invalid", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_BAD_REQUEST" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_RELATIONSHIP | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The caller has no legitimate relationship with the resource. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-found", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_FOUND" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.generateCRI": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to generate a PDF file that summarises clinical information for a referral.\n\nThis does not include files attached to a referral or advice request. These must be retrieved via [[HYPERLINK_A042]]\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\n## Important note\nA referral pathway in e-RS can be made up of more than one UBRN. For example, a referral is booked and seen in a general knee clinical assessment service (UBRN #1), \nand the service decides to onward refer to a more specialist knee miniscus service (UBRN #2). This would result in two UBRNs for the referral pathway \nin this example (but there could be more related UBRNs if onward referred multiple times).\n\nAs such, it is important that all clinical information is obtained from across all the related UBRNs referenced in [[HYPERLINK_A005]]. \nYou can do this using the following endpoints:\n - [[HYPERLINK_A007]]\n - [[HYPERLINK_A006]]\n\nNote: It is possible that the initial UBRN may be the only one in the referral pathway to have clinical information and/or attachments associated.\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve a clinical information summary (in PDF format) associated with the referral\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\nYou can retrieve clinical attachments that are associated with a referral using [[HYPERLINK_A006]].\n", - "summary": "Retrieve clinical information (A007, FHIR STU3)", - "operationId": "a007-retrieve-clinical-information", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "responses": { - "200": { - "description": "Response contains the binary stream of the clinical information summary (PDF).", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Disposition": { - "description": "The description of the type of content provided.\n", - "required": true, - "schema": { - "type": "string", - "example": "attachment; filename=\"000000070000_Appointment_Confirmation_Summary_20210603121353.pdf\"" - } - }, - "Content-Length": { - "description": "The length of the response.\n", - "required": true, - "schema": { - "type": "string", - "example": "3111" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/pdf" - ], - "example": "application/pdf" - } - } - }, - "content": { - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/HealthcareService/$ers.searchHealthcareServicesForPatient": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to find services that meet the referral needs of a patient.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a `patient`, for example via [[HYPERLINK_PDS]].\n\n## Use case\nAs an authenticated user\n\nI need to find services I can refer the patient to\n\nSo that I can offer the patient appropriate services that meet their referral needs\n\n## Important Notes\nIf using this endpoint for modifying an existing Referral (such as via the [[HYPERLINK_A031]] endpoint for example), you will need to provide the Commissioning Rule Organisation parameter. This ensures that the services returned in the response are valid for use with the Referral. You can obtain the 'Commissioning Rule Organisation' from [[HYPERLINK_A005]].\n\n## Related endpoints\nOnce you have identified appropriate services for the patient you can create a referral by choosing a shortlist of bookable and/or triage services using [[HYPERLINK_A011]]. You may then subsequently be able to use [[HYPERLINK_A016]] to book an appointment to a directly bookable service if an appointment slot is available, defer the booking responsibility to a directly bookable service if no appointment slot is available, or refer a patient into a triage service.\n", - "summary": "Patient service search (A010, FHIR STU3)", - "operationId": "a010-patient-service-search", - "tags": [ - "Refer patient", - "Request advice" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-PatientServiceSearch-Parameters", - "description": "The parameters used in patient services search", - "type": "object", - "required": [ - "meta", - "resourceType", - "parameter" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-PatientServiceSearch-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-PatientServiceSearch-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `RequestType` | `1..1` | |\n| `SortBy` | `1..1` | |\n| `Patient` | `1..1` | |\n| `SearchCriteria` | `1..1` | |\n| `ReferringClinician` | `0..1` | |\n| `CommissioningRuleOrganisation` | `0..1` | Required if searching for services for an existing Referral. This field should be provided using the returned Commissioning Rule Organisation already included on the Referral to ensure the services returned are valid. Note this field is not supported when searching with the `ADVICE_AND_GUIDANCE_REQUEST` request type. |\n", - "items": { - "anyOf": [ - { - "title": "RequestType", - "description": "The type of request in e-RS which this service search is aimed at creating or updating. \nThe options are appointment request (i.e. referral) or advice and guidance request. \nServices may support one or the other or both and will be filtered accordingly.\n", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "requestType" - ], - "example": "requestType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestType-1" - }, - "code": { - "type": "string", - "enum": [ - "APPOINTMENT_REQUEST", - "ADVICE_AND_GUIDANCE_REQUEST" - ], - "example": "APPOINTMENT_REQUEST" - } - } - } - } - }, - { - "title": "SortBy", - "description": "The service search returns the top results according to the sorting requested. \nTherefore, the sorting requested affects the selection of services that are included in the response.\n", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "sortBy" - ], - "example": "sortBy" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-SortBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-SortBy-1" - }, - "code": { - "type": "string", - "enum": [ - "DISTANCE", - "IWT" - ], - "example": "IWT" - }, - "display": { - "type": "string", - "example": "Indicative Appointment Wait Time" - } - } - } - } - }, - { - "title": "Patient", - "description": "Parameter to supply a patient", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - { - "title": "ReferringClinician", - "description": "Parameter to supply a referring clinician", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "referringClinician" - ], - "example": "referringClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "CommissioningRuleOrganisation", - "description": "Parameter to supply a commissioning rule organisation", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningRuleOrganisation" - ], - "example": "commissioningRuleOrganisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "SearchCriteria", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "searchCriteria" - ], - "example": "searchCriteria" - }, - "resource": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "rc-minimal": { - "summary": "Referring Clinician minimal search", - "value": { - "$ref": "../../examples/patientServiceSearch/requests/RcMinimal.json" - } - }, - "rc-search-by-clinical-term": { - "summary": "Referring Clinician search by clinical term", - "value": { - "$ref": "../../examples/patientServiceSearch/requests/RcSearchByClinicalTerm.json" - } - }, - "rc-search-by-named-clinician": { - "summary": "Referring Clinician search by named clinician", - "value": { - "$ref": "../../examples/patientServiceSearch/requests/RcSearchByNamedClinician.json" - } - }, - "rc-search-for-advice-service": { - "summary": "Referring Clinician search for services supporting Advice Requests", - "value": { - "$ref": "../../examples/patientServiceSearch/requests/RcSearchForAdviceService.json" - } - }, - "rca-with-iwt": { - "summary": "Referring Clinician Admin search", - "value": { - "$ref": "../../examples/patientServiceSearch/requests/RcaWithIWT.json" - } - }, - "rc-search-with-commissoning-rule-organisation": { - "summary": "Referring Clinician search with commissioning rule organisation", - "value": { - "$ref": "../../examples/patientServiceSearch/requests/RcSearchWithCommissioningRuleOrganisation.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "The response body contains the list of services (if any) that match the search criteria provided", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-FetchServices-List", - "description": "Service search response", - "type": "object", - "required": [ - "meta", - "resourceType", - "status", - "mode", - "entry" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchServices-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchServices-List-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "emptyReason": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/list-empty-reason" - ], - "example": "http://hl7.org/fhir/ValueSet/list-empty-reason" - }, - "code": { - "type": "string", - "enum": [ - "nilknown", - "notasked", - "withheld", - "unavailable", - "notstarted", - "closed" - ], - "example": "nilknown" - }, - "display": { - "type": "string", - "example": "no results" - } - } - } - } - } - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item", - "extension" - ], - "properties": { - "extension": { - "title": "Extension to supply search specific details for a service", - "type": "array", - "items": { - "title": "Extension-eRS-ServiceSearch-ListItem", - "type": "object", - "required": [ - "extension", - "url" - ], - "properties": { - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `DisplayProminently` | `1..1` | |\n| `Distance` | `0..1` | |\n| `IndicativeAppointmentWaitTime` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "DisplayProminently", - "description": "Extension to supply display prominently indicator", - "type": "object", - "required": [ - "url", - "valueBoolean" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "displayProminently" - ], - "example": "displayProminently" - }, - "valueBoolean": { - "type": "boolean", - "example": false - } - } - }, - { - "title": "Distance", - "description": "Extension to supply distance value", - "type": "object", - "required": [ - "url", - "valueUnsignedInt" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "distance" - ], - "example": "distance" - }, - "valueUnsignedInt": { - "type": "integer", - "format": "int32", - "example": 10 - } - } - }, - { - "title": "IndicativeAppointmentWaitTime", - "description": "Extension to supply indicative wait time, only one extension with url value 'indicativeAppointmentWaitTime' will be returned at once", - "type": "object", - "required": [ - "url", - "valueUnsignedInt" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTime" - ], - "example": "indicativeAppointmentWaitTime" - }, - "valueUnsignedInt": { - "type": "integer", - "format": "int32", - "example": 7 - } - } - }, - { - "title": "IndicativeAppointmentWaitTime", - "description": "Extension to supply indicative wait time, only one extension with url value 'indicativeAppointmentWaitTime' will be returned at once", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTime" - ], - "example": "indicativeAppointmentWaitTime" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-IWT-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-IWT-1" - }, - "code": { - "type": "string", - "enum": [ - "LIMITED_AVAILABILITY", - "NOT_APPLICABLE" - ], - "example": "LIMITED_AVAILABILITY" - } - } - } - } - } - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - }, - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSearch-ListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSearch-ListItem-1" - } - } - } - }, - "item": { - "type": "object", - "required": [ - "extension", - "identifier" - ], - "properties": { - "extension": { - "type": "array", - "items": { - "title": "Extension-eRS-ServiceSummaryView", - "description": "Extension to supply service summary view", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSummaryView-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ServiceSummaryView-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| -------------------------------- | ----------- | ------------------------------------------ |\n| `SupportedAppointmentType` | `0..1` | |\n| `ServiceName` | `1..1` | |\n| `SupportedRequestFlowType` | `1..2` | |\n| `IndicativeTreatmentWaitTime` | `0..1` | |\n| `BookableType` | `1..1` | |\n| `Location` | `1..1` | |\n| `ReferrerAlert` | `0..1` | |\n| `Exclusions` | `0..1` | |\n| `SuggestedInvestigations` | `0..1` | |\n| `ConditionsTreated` | `0..1` | |\n| `GenderTreated` | `1..1` | Sex treated. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `AdditionalRequirementSupported` | `0..3` | |\n| `ReferralLetterRequired` | `1..1` | |\n| `Specialty` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "SupportedAppointmentType", - "description": "Supported appointment type", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "supportedAppointmentType" - ], - "example": "supportedAppointmentType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AppointmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "DAY_CASE", - "FIRST_OUTPATIENT", - "ASSESSMENT_SERVICE", - "GPSI", - "AHP_CLINIC", - "DIAGNOSTIC", - "NURSE_CLINIC", - "OPHTHALMOLOGIST", - "TELEPHONE_ASSESSMENT" - ], - "example": "DIAGNOSTIC" - } - } - } - } - } - } - } - }, - { - "title": "ServiceName", - "description": "Name of the service.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "serviceName" - ], - "example": "serviceName" - }, - "valueString": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - }, - { - "title": "SupportedRequestFlowType", - "description": "Services can support one or two Request Flow Types, but not Triage Request and Appointment Request simultaneously.", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "supportedRequestFlowType" - ], - "example": "supportedRequestFlowType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestFlowType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestFlowType-1" - }, - "code": { - "type": "string", - "enum": [ - "APPOINTMENT_REQUEST", - "TRIAGE_REQUEST", - "ADVICE_AND_GUIDANCE_REQUEST" - ], - "example": "APPOINTMENT_REQUEST" - } - } - } - } - } - } - } - }, - { - "title": "IndicativeTreatmentWaitTime", - "description": "Statistical indication of how long Patients have waited before receiving treatment.", - "type": "object", - "required": [ - "url", - "valueUnsignedInt" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "indicativeTreatmentWaitTime" - ], - "example": "indicativeTreatmentWaitTime" - }, - "valueUnsignedInt": { - "type": "integer", - "format": "int32", - "example": 15 - } - } - }, - { - "title": "IndicativeTreatmentWaitTime", - "description": "Statistical indication of how long Patients have waited before receiving treatment.", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "indicativeTreatmentWaitTime" - ], - "example": "indicativeTreatmentWaitTime" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CapacityAlert-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CapacityAlert-1" - }, - "code": { - "type": "string", - "enum": [ - "LOW" - ], - "example": "LOW" - } - } - } - } - } - } - } - }, - { - "title": "BookableType", - "description": "Whether the service is Directly or Indirectly Bookable", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "bookableType" - ], - "example": "bookableType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BookableType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BookableType-1" - }, - "code": { - "type": "string", - "enum": [ - "DIRECTLY_BOOKABLE", - "INDIRECTLY_BOOKABLE", - "UNSPECIFIED" - ], - "example": "DIRECTLY_BOOKABLE" - } - } - } - } - } - } - } - }, - { - "title": "LinkToNHSWebsite", - "description": "Link to NHS website providing information about the Service such as contact details, map, department, facilities and reviews.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "linkToNHSWebsite" - ], - "example": "linkToNHSWebsite" - }, - "valueString": { - "type": "string", - "example": "https://www.nhs.uk/service-search/other-services/chooseandbook?serviceId=11002" - } - } - }, - { - "title": "Location", - "description": "Service location", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "location" - ], - "example": "location" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - }, - "display": { - "type": "string", - "example": "Cicero-Clinic" - } - } - } - } - }, - { - "title": "ReferrerAlert", - "description": "Referrer Alert", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrerAlert" - ], - "example": "referrerAlert" - }, - "valueString": { - "type": "string", - "example": "Surgery and post op follow up will be done at Harrogate District Hospital" - } - } - }, - { - "title": "Exclusions", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "exclusions" - ], - "example": "Service Users under the age of 18" - }, - "valueString": { - "type": "string", - "example": "Exclusions" - } - } - }, - { - "title": "SuggestedInvestigations", - "description": "Suggested investigations", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "suggestedInvestigations" - ], - "example": "suggestedInvestigations" - }, - "valueString": { - "type": "string", - "example": "Relevant Xray" - } - } - }, - { - "title": "ConditionsTreated", - "description": "Conditions treated", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "conditionsTreated" - ], - "example": "conditionsTreated" - }, - "valueString": { - "type": "string", - "example": "Hip pain" - } - } - }, - { - "title": "AgeTreated", - "description": "Age range treated", - "type": "object", - "required": [ - "url", - "valueRange" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "ageTreated" - ], - "example": "ageTreated" - }, - "valueRange": { - "type": "object", - "required": [ - "low", - "high" - ], - "properties": { - "low": { - "type": "object", - "required": [ - "value", - "unit" - ], - "properties": { - "value": { - "type": "integer", - "example": 18 - }, - "unit": { - "type": "string", - "enum": [ - "YEARS", - "MONTHS" - ], - "example": "YEARS" - } - } - }, - "high": { - "type": "object", - "required": [ - "value", - "unit" - ], - "properties": { - "value": { - "type": "integer", - "example": 100 - }, - "unit": { - "type": "string", - "enum": [ - "YEARS", - "MONTHS" - ], - "example": "YEARS" - } - } - } - } - } - } - }, - { - "title": "GenderTreated", - "description": "Sex treated", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "genderTreated" - ], - "example": "genderTreated" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GenderTreated-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GenderTreated-1" - }, - "code": { - "type": "string", - "enum": [ - "MALE", - "FEMALE", - "MALE_AND_FEMALE" - ], - "example": "MALE_AND_FEMALE" - } - } - } - } - } - } - } - }, - { - "title": "AdditionalRequirementSupported", - "description": "Additional support services provided by the Organisation where the Service is located at", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "additionalRequirementSupported" - ], - "example": "additionalRequirementSupported" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "TRANSPORT", - "INTERPRETER", - "ADVOCACY" - ], - "example": "ADVOCACY" - } - } - } - } - } - } - } - }, - { - "title": "ReferralLetterRequired", - "description": "Indicates whether the Service requires a referral letter before they consider a referral to be valid", - "type": "object", - "required": [ - "url", - "valueBoolean" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLetterRequired" - ], - "example": "referralLetterRequired" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "Specialty", - "description": "The specialty supported by the Service", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - } - ] - } - } - } - } - }, - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - }, - "examples": { - "fetch-service-list-single-service": { - "summary": "With single service", - "value": { - "$ref": "../../../examples/patientServiceSearch/responses/FetchServiceListWithSingleService.json" - } - }, - "fetch-service-list-multiple-services": { - "summary": "With multiple services", - "value": { - "$ref": "../../../examples/patientServiceSearch/responses/FetchServiceListWithMultipleServices.json" - } - }, - "fetch-service-list-multiple-request-types": { - "summary": "With multiple supported request flow types", - "value": { - "$ref": "../../../examples/patientServiceSearch/responses/TriageAndAppointmentRequestType.json" - } - }, - "fetch-service-list-with-indicative-appointment-wait-time": { - "summary": "With indicative appointment wait time", - "value": { - "$ref": "../../../examples/patientServiceSearch/responses/WithIndicativeAppointmentWaitTime.json" - } - }, - "fetch-service-list-empty": { - "summary": "Empty result list", - "value": { - "$ref": "../../../examples/patientServiceSearch/responses/EmptyResponse.json" - } - }, - "fetch-advice-services": { - "summary": "With advice service", - "value": { - "$ref": "../../../examples/patientServiceSearch/responses/AdviceServiceSearch.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/$ers.createReferral": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to create a referral by choosing a shortlist of bookable services and/or triage services.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Important notes when creating a referral\nThe maximum amount of services allowed on a given shortlist is 20.\n\nThe act of shortlisting alone will not result in a referral being sent/booked to any of the shortlisted services (even if only one service is shortlisted).\nA shortlist of a single triage service should be avoided as this relies on the patient to progress the referral, potentially leading to a delay to care. Especially if the referral priority is 2WW or Urgent.\n\nUse [[HYPERLINK_A016]] if there is a need to support the sending/booking of the referral into a shortlisted service.\n\n## Important notes when sending an e-Referral Pathway Start Date\nThe e-Referral Pathway Start Date is a derived value of when the Referral To Treatment (RTT) clock starts. Find out how e-RS derives the pathway start date [[HYPERLINK_PATHWAY_START]].\n\nYou can supply an optional, alternate pathway start date when creating a referral.\n\nThis may be because steps, such as reviews, take place early in your business process. Which means the clock started earlier than when the e-RS referral is created. \nProviding an alternate pathway start date ensures the correct date is recorded and used in other systems.\n\nWhen provided, the pathway start date must be:\n - in the past\n - no longer than 365 days ago\n - calculated in line with [[HYPERLINK_RTT_RULES]]\n\nThis also overrides any e-RS derived date.\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a `patient`, for example via [[HYPERLINK_PDS]].\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Use case\nAs an authenticated user\n\nI need to create a shortlist of bookable services and/or triage services\n\nSo I can initiate my patients referral pathway, allowing the patient to book into one of the shortlisted services.\n\n## Related endpoints\n\nTo allow the patient to progress their referral in their own time, you can generate a letter for the patient by \nusing [[HYPERLINK_A019]]. The letter summarises the current state of the referral and any steps the \npatient may need to follow (e.g. appointment booking instructions).\n\nYou can book an appointment for the patient into a shortlisted directly bookable service using [[HYPERLINK_A015]] and [[HYPERLINK_A016]].\n\nYou can send the referral into a shortlisted triage service using [[HYPERLINK_A016]]. \n\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\nYou can generate a letter for the patient, which summarises the current state of their referral and any steps the patient may need to follow, by using [[HYPERLINK_A019]].\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Create referral (A011, FHIR STU3)", - "operationId": "a011-create-referral", - "tags": [ - "Refer patient" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CreateReferral-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferral-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferral-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `ReferringClinician` | `0..1` | |\n| `Shortlist` | `1..1` | |\n| `IntentionToAddReferralLetter` | `1..1` | | \n| `FirstReminderLetterFollowUpDays` | `1..1` | | \n| `EReferralPathwayStart` | `0..1` | | \n", - "items": { - "anyOf": [ - { - "title": "Patient", - "description": "Parameter to supply a patient", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - { - "title": "ReferringClinician", - "description": "Parameter to supply a referring clinician", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "referringClinician" - ], - "example": "referringClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "Shortlist", - "description": "Parameter to supply a shortlist", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "shortlist" - ], - "example": "shortlist" - }, - "resource": { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - } - } - }, - { - "title": "IntentionToAddReferralLetter", - "description": "Parameter to supply the intention to add referral letter flag", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "intentionToAddReferralLetter" - ], - "example": "intentionToAddReferralLetter" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - }, - "code": { - "type": "string", - "enum": [ - "NEED_TO_ADD_LATER", - "NOT_INTENDING_TO_ADD" - ], - "example": "NEED_TO_ADD_LATER" - } - } - } - } - }, - { - "title": "FirstReminderLetterFollowUpDays", - "description": "Parameter to supply the first reminder follow up days", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "firstReminderLetterFollowUpDays" - ], - "example": "firstReminderLetterFollowUpDays" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 0 - } - } - }, - { - "title": "EReferralPathwayStart", - "description": "Parameter to supply the pathway start date", - "type": "object", - "required": [ - "name", - "valueInstant" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "eReferralPathwayStart" - ], - "example": "eReferralPathwayStart" - }, - "valueInstant": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - } - } - }, - "examples": { - "rc-minimum-request-body": { - "summary": "Referring Clinician - minimum request body", - "value": { - "$ref": "../../examples/createReferral/requests/MinimalRequest.json" - } - }, - "rc-request-body-multi-service-shortlist": { - "summary": "Referring Clinician - request body using multi-service shortlist", - "value": { - "$ref": "../../examples/createReferral/requests/RequestTwentyServices.json" - } - }, - "rc-request-body-mixed-shortlist": { - "summary": "Referring Clinician - request body using mixed service shortlist", - "value": { - "$ref": "../../examples/createReferral/requests/RequestMixedShortlist.json" - } - }, - "create-referral-parameters-twenty-services": { - "summary": "Referring Clinician Admin - minimum request body", - "value": { - "$ref": "../../examples/createReferral/requests/MinimalRequestWithReferringClinician.json" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "A referral created within e-RS.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "referral-request-single-service": { - "summary": "Example with single service", - "value": { - "$ref": "../../../examples/createReferral/responses/ReferralRequest.json" - } - }, - "referral-request-twenty-services": { - "summary": "Example with twenty services", - "value": { - "$ref": "../../../examples/createReferral/responses/ReferralRequestTwentyServices.json" - } - }, - "referral-request-mixed-shortlist": { - "summary": "Example with a shortlist containing bookable and triage services", - "value": { - "$ref": "../../../examples/createReferral/responses/ReferralRequestMixedShortlist.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/$ers.createReferralAndSendForTriage": { - "post": { - "deprecated": true, - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n**This endpoint has now been deprecated please use [[HYPERLINK_A011]] instead.**\n\nUse this endpoint to refer the patient directly to a triage service.\n\nPlease note: this endpoint cannot be used to shortlist bookable services. In order to shortlist bookable services please use [[HYPERLINK_A011]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a `patient`, for example via [[HYPERLINK_PDS]].\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Use case\nAs an authenticated user\n\nI need to send the patient's referral to a triage service for assessment\n\nSo that I can put the patient on the appropriate clinical pathway for the chosen service provider.\n\n## Related endpoints\n\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\nYou can generate a letter for the patient by using [[HYPERLINK_A019]]. \nThe letter summarises the current state of the referral and any steps the patient may need to follow.\n\nYou can calculate the date when the patient will need to be contacted (by the triage service) using reference data from [[HYPERLINK_A004]].\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Create referral and send for triage (A021, FHIR STU3) [deprecated]", - "operationId": "a021-create-referral-request-and-send-for-triage", - "tags": [ - "Refer patient" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CreateReferralAndSendForTriage-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferralAndSendForTriage-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateReferralAndSendForTriage-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `ReferringClinician` | `0..1` | |\n| `Shortlist` | `1..1` | |\n| `IntentionToAddReferralLetter` | `1..1` | | \n| `FirstReminderLetterFollowUpDays` | `1..1` | | \n", - "items": { - "anyOf": [ - { - "title": "Patient", - "description": "Parameter to supply a patient", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - { - "title": "ReferringClinician", - "description": "Parameter to supply a referring clinician", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "referringClinician" - ], - "example": "referringClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "Shortlist", - "description": "Parameter to supply a shortlist. When sending for triage, \nthe shortlist must contain exactly one service, and this must support the 'triage request flow'.\n", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "shortlist" - ], - "example": "shortlist" - }, - "resource": { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - } - } - }, - { - "title": "IntentionToAddReferralLetter", - "description": "Parameter to supply the intention to add referral letter flag.\nWhen sending for triage, a referral letter is always required, therefore the only acceptable value is NEED_TO_ADD_LATER.\n", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "intentionToAddReferralLetter" - ], - "example": "intentionToAddReferralLetter" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - }, - "code": { - "type": "string", - "enum": [ - "NEED_TO_ADD_LATER" - ], - "example": "NEED_TO_ADD_LATER" - } - } - } - } - }, - { - "title": "FirstReminderLetterFollowUpDays", - "description": "Parameter to supply the first reminder follow up days. When sending for triage, \nthe only acceptable value is 0, which means no follow up letter will be sent, \nas the patient does not need to book an appointment.\n", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "firstReminderLetterFollowUpDays" - ], - "example": "firstReminderLetterFollowUpDays" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 0 - } - } - } - ] - } - } - } - }, - "examples": { - "parameters": { - "summary": "Referring Clinician creates referral to a Triage service", - "value": { - "$ref": "../../examples/createReferralAndSendForTriage/requests/Parameters.json" - } - }, - "parameters-with-named-clinician": { - "summary": "Referring Clinician Admin minimum call", - "value": { - "$ref": "../../examples/createReferralAndSendForTriage/requests/ParametersWithNamedClinician.json" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "A referral created within e-RS.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "referral-request-with-appointment": { - "summary": "Basic example", - "value": { - "$ref": "../../../examples/createReferralAndSendForTriage/responses/ReferralRequest.json" - } - }, - "referral-request-with-named-clinician": { - "summary": "Example with named clinician in search criteria", - "value": { - "$ref": "../../../examples/createReferralAndSendForTriage/responses/ReferralRequestWithNamedClinician.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Slot": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve available appointment slots for a service.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a directly bookable `service` that is on the current referral shortlist. You can do this by using [[HYPERLINK_A005]].\n\n## Use case\n\nAs an authenticated user\n\nI need to retrieve a list of available appointment slots for a service\n\nSo that I can offer them to the patient for booking.\n\n## Important note\nYou need to provide the 'commissioning rule organisation' when calling [[HYPERLINK_A015]] to ensure only suitable slots are returned. You can obtain the 'commissioning rule organisation' from [[HYPERLINK_A005]].\n\nWhen slots are retrieved using this endpoint, they can include slots with or without a named clinician associated with them. Your integrated application must support both scenarios.\n\nSlots with a named clinician will have an additional \"actor\" which defines the SDS User ID of the clinician, this will be on the Schedule associated to the Slot.\n\n## Related endpoints\n\nYou can book an appointment to an available slot using [[HYPERLINK_A016]].\n\nYou can defer booking to a directly bookable service using [[HYPERLINK_A016]] but only in the following circumstances:\n - when the service has no available slots\n - when trying to book an appointment into a service, the slot advertised is no longer available\n - when trying to book an appointment into a service, no response is received within message timeout period (currently 2 minutes)\n\n## Known Issues\nThis endpoint is using the :Practitioner search parameter. The \"schedule.actor\" search parameter is incorrectly using the \":Practitioner\" modifier. As per the [FHIR standard](https://hl7.org/fhir/R4/) the \":identifier\" modifier should be used when searching to indicate that an Identifer is used rather than a literal, relative, internal or absolute reference. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment:\n\n| Scenario | Request Query Parameters | Response |\n| -------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------- |\n| Minimum slot search | `schedule.actor:HealthcareService`=`12000`, `appointmentType`=`ROUTINE`, `_count`=`20`, `status`=`free`, `page`=`1` | Illustrates minimum usage/parameters with concise, minimal response. |\n| Empty slot search response | `schedule.actor:HealthcareService`=`10000`, `appointmentType`=`ROUTINE`, `_count`=`20`, `status`=`free`, `page`=`1` | Illustrates how a 'no slots' response appears. |\n| Multipage slot search (page 1) | `schedule.actor:HealthcareService`=`11000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`1` | Illustrates first page of multi-page response. |\n| Multipage slot search (page 2) | `schedule.actor:HealthcareService`=`11000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`2` | Illustrates second page of multi-page response. |\n| Multipage slot search (invalid page 5) | `schedule.actor:HealthcareService`=`11000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`5` | Illustrates error when page is outside of valid range. |\n| Multi schedule response | `schedule.actor:HealthcareService`=`13000`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`1` | Illustrates response when there is >1 Schedule: one Schedule is for slots with no associated clinician and the other does have an associated clinician. |\n| Slot clinician search | `schedule.actor:HealthcareService`=`14000`, `schedule.actor:Practitioner`=`921600556514`, `appointmentType`=`ROUTINE`, `_count`=`5`, `status`=`free`, `page`=`1` | Illustrates search for clinician-specific slots |\n", - "summary": "Retrieve appointment slots (A015, FHIR STU3)", - "operationId": "a015-retrieve-appointment-slots", - "tags": [ - "Arrange appointment" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Comm-Rule-Org", - "description": "To retrieve accurate slot information for a specific ReferralRequest the code from the ReferralRequest's 'Extension-eRS-Commissioning-Rule-Org-1' field should be passed to the slot search in this field otherwise slots which are, in fact, unbookable for that ReferralRequest may be returned\n", - "required": true, - "schema": { - "type": "string", - "example": "R68" - } - }, - { - "in": "query", - "name": "schedule.actor:HealthcareService", - "description": "A single service ID is required to indicate the service for which appointment slots are required.\n", - "required": true, - "schema": { - "type": "string", - "example": "11000" - } - }, - { - "in": "query", - "name": "appointmentType", - "description": "The priority of the appointment slots.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "ROUTINE" - } - }, - { - "in": "query", - "name": "status", - "description": "The status of the appointment slots required must be supplied. This must indicate that 'free' slots are required.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "free" - ], - "example": "free" - } - }, - { - "in": "query", - "name": "_count", - "description": "The pageSize is the maximum number of results (i.e. slots) that should be returned by this call. This value must be in the range of 1-100. 100 is the maximum slots available per API call.\n**Note:** Page contents cannot be guaranteed to be contiguous with no gaps or duplicates since the availability of slots may change between calls to the API.\n", - "required": true, - "schema": { - "type": "integer", - "minimum": 1, - "maximum": 100, - "format": "int32", - "example": 5 - } - }, - { - "in": "query", - "name": "page", - "description": "The number of the page required to be returned, starting at 1.\n", - "required": true, - "schema": { - "type": "integer", - "minimum": 1, - "format": "int32", - "example": 1 - } - }, - { - "in": "query", - "name": "schedule.actor:Practitioner", - "description": "Slots in e-RS may be allocated to a clinician and is set in the service provider's PAS. \nIf a named clinician is supplied (by the UUID), the appointment slots returned are constrained to slots for which this clinician is allocated to the appointment slot. \nThe clinician must be a named clinician for the selected service.\n", - "required": false, - "schema": { - "type": "string", - "example": "921600556514" - } - }, - { - "in": "query", - "name": "_include", - "description": "An optional URL parameter to cause service/clinician information to be returned ('_include=Slot:schedule') is recognised (i.e. causes no error and is understood by e-RS) but e-RS will return a Schedule for each Slot whether this parameter is present or not.\n", - "required": false, - "schema": { - "type": "string", - "example": "Slot:schedule" - } - } - ], - "responses": { - "200": { - "description": "The Response contains a FHIR 'Bundle' that, in turn, contains 'Slot' resources where each 'Slot' resource includes the 'Reference' to the slot and the slot's 'start' and 'end' times.\n\nThe Response Bundle also contains one or more 'Schedule' resources each of which is used to indicate which allocated clinician a Slot is associated with (if any). \nThe 'Schedule' also indicates the Service Id that will be the same Service for which the Slot search was performed.\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "Bundle resource containing appointment slots", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "type", - "total", - "link", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "08acc887-6a7b-4b38-8f50-022e41319efe" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated", - "profile" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" - ], - "example": "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Bundle" - ], - "example": "Bundle" - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "total": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 3 - }, - "link": { - "type": "array", - "minItems": 1, - "maxItems": 3, - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self", - "previous", - "next" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/STU3/Slot?schedule.actor%3AHealthcareService=11010&appointmentType=ROUTINE&_count=10&status=free&_include=Slot%3Aschedule&page=1" - } - } - } - }, - "entry": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Slot` | `1..*` | |\n| `Schedule` | `1..*` | |\n", - "items": { - "anyOf": [ - { - "title": "Slot", - "description": "Slot resource includes the 'Reference' to the slot and the slot's 'start' and 'end' times.\n", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/STU3/Slot/11000010" - }, - "resource": { - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier", - "schedule", - "status", - "start", - "end" - ], - "properties": { - "id": { - "type": "string", - "example": "11000009" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Slot-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Slot-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Slot" - ], - "example": "Slot" - }, - "identifier": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/alternative-slot" - ], - "example": "https://fhir.nhs.uk/Id/alternative-slot" - }, - "value": { - "type": "string", - "example": "USRN-11000009" - } - } - } - }, - "schedule": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Schedule/11000-921600556514" - } - } - }, - "status": { - "type": "string", - "enum": [ - "free" - ], - "example": "free" - }, - "start": { - "type": "string", - "format": "date-time", - "example": "2021-05-19T18:00:00.000Z" - }, - "end": { - "type": "string", - "format": "date-time", - "example": "2021-05-19T19:00:00.000Z" - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - } - } - }, - { - "title": "Schedule", - "description": "Schedule resource is used to indicate which allocated clinician a Slot is associated with (if any). \nThe 'Schedule' also indicates the Service Id that will be the same Service for which the Slot search was performed\n", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/STU3/Schedule/11000-921600556514" - }, - "resource": { - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier", - "actor" - ], - "properties": { - "id": { - "type": "string", - "example": "11000-921600556514" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Schedule-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Schedule-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Schedule" - ], - "example": "Schedule" - }, - "identifier": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ers-schedule" - ], - "example": "https://fhir.nhs.uk/Id/ers-schedule" - }, - "value": { - "type": "string", - "example": "11000-921600556514" - } - } - } - }, - "actor": { - "type": "array", - "minItems": 1, - "maxItems": 2, - "items": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "anyOf": [ - { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - ] - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "include" - ], - "example": "include" - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "minimum": { - "summary": "Minimum slot search", - "value": { - "$ref": "../../../examples/retrieveAppointmentSlots/responses/Minimum.json" - } - }, - "empty": { - "summary": "Empty slot search response", - "value": { - "$ref": "../../../examples/retrieveAppointmentSlots/responses/NoSlots.json" - } - }, - "page1of2": { - "summary": "Multipage slot search (page 1)", - "value": { - "$ref": "../../../examples/retrieveAppointmentSlots/responses/Page1PageSize5.json" - } - }, - "page2of2": { - "summary": "Multipage slot search (page 2)", - "value": { - "$ref": "../../../examples/retrieveAppointmentSlots/responses/Page2PageSize5.json" - } - }, - "multi-schedule": { - "summary": "Multi schedule response", - "value": { - "$ref": "../../../examples/retrieveAppointmentSlots/responses/Page1With2Schedules.json" - } - }, - "slot-clinician-search": { - "summary": "Slot clinician search", - "value": { - "$ref": "../../../examples/retrieveAppointmentSlots/responses/SlotClinicianSearch.json" - } - } - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| MISSING_PARAMETER | Indicates missing mandatory FHIR search parameter. |\n| MISSING_HEADER | Indicates missing mandatory HTTP header. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| SERVICE_UNAVAILABLE | Indicates that a service is no longer available. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "INVALID_VALUE", - "display": "Invalid value" - } - ] - }, - "diagnostics": "'Page Number' (5) is invalid." - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Appointment": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to book an appointment to a directly bookable service if an appointment slot is available, defer the booking responsibility to a directly bookable service if no appointment slot is available, or refer a patient into a triage service. \n\nIt is not possible to book into an indirectly bookable service using this endpoint. The patient will need to contact the service provider on the telephone number provided on [[HYPERLINK_A019]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to check if the service is directly bookable, indirectly bookable, or triage by either using [[HYPERLINK_A033]] or [[HYPERLINK_A035]]. You can then offer appropriate actions to authenticated users, i.e. the ability to book an appointment into a directly bookable service if an appointment slot is available, defer the booking responsibility to a directly bookable service if no appointment slot is available, refer a patient into a triage service.\n\nIf the service is directly bookable, you need to retrieve available appointment slots for the service using [[HYPERLINK_A015]].\n\nYou need to use the Unique Booking Reference Number (UBRN) of a referral request in order to use this endpoint. \n\n## Important note when deferring to provider\n\nYou should only defer booking to a directly bookable service in the following circumstances:\n - when the service has no available slots *or*\n - when trying to book an appointment into a service, the slot advertised is no longer available *or*\n - when trying to book an appointment into a service, no response is received within the message timeout period (currently 2 minutes)\n\n## Important note when booking slots\n\nWhen appointment slots are booked using this endpoint, it may be necessary to provide the named clinician details. This is because slots can be setup with or without a named clinician. Your integrated application must support both scenarios.\n\nWhen booking a slot using [[HYPERLINK_A016]], the named clinician details must be added to the \"Appointment.partcipant\" list. As shown in the \"Booking with named clinician\" example.\n\n## Use case\nAs an authenticated user\n\nI need to be able to\n - Book an appointment into an available appointment slot for a directly bookable service *or*\n - Defer the booking responsibility to a directly bookable service if no appointment slot is available *or*\n - Refer the patient into a triage service\n\nSo I can progress my patient's care at that service.\n\n## Related endpoints\nYou can generate a letter for the patient, summarising the current state of their referral and any steps \nthe patient may need to follow using [[HYPERLINK_A019]].\n\nWhere deferring the booking responsibility to a directly bookable service, or referring the patient into a triage service, you can calculate the date when the patient can expect to be contacted (by the receiving service) using reference data from [[HYPERLINK_A004]].\n\n ## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Book or defer appointment (A016, FHIR STU3)", - "operationId": "a016-book-or-defer-appointment", - "tags": [ - "Arrange appointment", - "Arrange triage" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - "examples": { - "minimal-booking": { - "summary": "Minimum booking", - "value": { - "$ref": "../../examples/bookOrDeferAppointment/requests/MinimalBooking.json" - } - }, - "minimal-deferral": { - "summary": "Minimum deferral", - "value": { - "$ref": "../../examples/bookOrDeferAppointment/requests/MinimalDeferral.json" - } - }, - "triage-deferral": { - "summary": "Triage deferral", - "value": { - "$ref": "../../examples/bookOrDeferAppointment/requests/TriageDeferral.json" - } - }, - "booking-with-named-clinician": { - "summary": "Booking with named clinician", - "value": { - "$ref": "../../examples/bookOrDeferAppointment/requests/BookingWithNamedClinician.json" - } - }, - "deferral-with-slot-reference": { - "summary": "Deferral with slot reference", - "value": { - "$ref": "../../examples/bookOrDeferAppointment/requests/DeferralWithSlotReference.json" - } - }, - "deferral-booking-attempt-problem": { - "summary": "Deferral booking attempt problem", - "value": { - "$ref": "../../examples/bookOrDeferAppointment/requests/DeferralBookingAttemptProblem.json" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "An appointment within e-RS.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - "examples": { - "minimal-booking": { - "summary": "Minimum booking", - "value": { - "$ref": "../../../examples/bookOrDeferAppointment/responses/MinimalBooking.json" - } - }, - "minimal-deferral": { - "summary": "Minimum deferral", - "value": { - "$ref": "../../../examples/bookOrDeferAppointment/responses/MinimalDeferral.json" - } - }, - "triage-deferral": { - "summary": "Triage deferral", - "value": { - "$ref": "../../../examples/bookOrDeferAppointment/responses/TriageDeferral.json" - } - }, - "booking-with-named-clinician": { - "summary": "Booking with named clinician", - "value": { - "$ref": "../../../examples/bookOrDeferAppointment/responses/BookingWithNamedClinician.json" - } - }, - "deferral-with-slot-reference": { - "summary": "Deferral with slot reference", - "value": { - "$ref": "../../../examples/bookOrDeferAppointment/responses/DeferralWithSlotReference.json" - } - }, - "deferral-booking-attempt-problem": { - "summary": "Deferral booking attempt problem", - "value": { - "$ref": "../../../examples/bookOrDeferAppointment/responses/DeferralBookingAttemptProblem.json" - } - } - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| SERVICE_UNAVAILABLE | Indicates that a service is no longer available. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| INAPPROPRIATE_SLOT | The slot provided is not suitable. |\n| SLOT_NOT_AVAILABLE | Slot is no longer available. |\n| UNABLE_TO_CONFIRM_APPOINTMENT | An unexpected error prevented eRS from successfully confirming the appointment. |\n| SLOTS_CURRENTLY_AVAILABLE | There are currently future slots available, so you cannot defer to this Service to book. |\n| THIS_SLOT_IS_AVAILABLE | Slot is currently available. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "502": { - "description": "Where status code 502 (Bad Gateway) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_RESPONDED_WITH_ERROR | Error received from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_RESPONDED_WITH_ERROR", - "display": "Error received from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: ERROR" - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - }, - "504": { - "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "timeout", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_NOT_RESPONDING", - "display": "No response from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" - } - ] - } - } - } - } - } - } - }, - "/STU3/Binary": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to upload a file containing clinical information to e-RS ready to be associated with a referral, an advice and guidance request or an advice and guidance response.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou can only upload file formats that are supported by e-RS. Currently, the supported file formats are:\n\n| File type | File extension(s) |\n| ------------------ | --------------------------- |\n| Plain Text | `.txt` |\n| PDF | `.pdf` |\n| XML Text | `.xml` |\n| RTF Text | `.rtf`, `.rtx` |\n| Basic Audio | `.au` |\n| MPEG audio layer 3 | `.mp3` |\n| PNG Image | `.png` | \n| GIF Image | `.gif` |\n| JPEG Image | `.jpg,` `.jpe`, `.jpeg` |\n| TIFF Image | `.tif`, `.tiff` |\n| MPEG Video | `.mpg`, `.mpeg`, `.mpe` |\n| MSWORD | `.doc`, `.docx` |\n| DICOM | `.dcm` |\n\nCurrently, the maximum file size supported by e-RS is 5MB.\n\n## Use case\n\nAs an authenticated user\n\nI need to upload a referral letter or other clinical information file to e-RS\n\nSo that I can associate the file with an existing referral or advice and guidance request.\n\n## Important notes\n\nThis endpoint **only** performs the file upload and **does not** associate it with a referral. The uploaded file must be explicitly associated with a referral by, for example, using [[HYPERLINK_A012]].\n\nThe resulting URL within e-RS for the uploaded file is returned in the 'Location' header of the response.\n\nRequest header `NHSD-eRS-Referral-ID` - the ID (typically the UBRN) of the referral which the documents are intended for - is non-mandatory, but must be provided if this file is to be attached to an existing request.\n\n## Related endpoints\n\nYou can associate the uploaded file with a specific referral using:\n - [[HYPERLINK_A012]]\n - [[HYPERLINK_A022]]\n - [[HYPERLINK_A028]]\n\nYou can associate the uploaded file with a specific advice and guidance request using:\n - [[HYPERLINK_A044]]\n - [[HYPERLINK_A026]]\n - [[HYPERLINK_A027]]\n", - "summary": "Upload file to document store (A020, FHIR STU3)", - "operationId": "a020-upload-file-to-document-store", - "tags": [ - "Refer patient", - "Request advice", - "Arrange appointment", - "Arrange triage" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "NHSD-eRS-File-Name", - "description": "The name of file being uploaded, including the extension\n", - "required": true, - "schema": { - "type": "string", - "example": "test.txt" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Referral-ID", - "description": "The ID (typically the UBRN) of the referral which the documents are intended for. This must be provided if this file is to be attached to an existing request.\n", - "required": false, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "requestBody": { - "required": true, - "content": { - "text/plain": { - "schema": { - "type": "string", - "format": "binary" - }, - "example": "This is some example text." - }, - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/xml": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/rtf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/basic": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/png": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/gif": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/jpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/tiff": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "video/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/msword": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/dicom": { - "schema": { - "type": "string", - "format": "binary" - } - } - } - }, - "responses": { - "201": { - "description": "201 (Created) - success response with no body", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Location": { - "description": "The e-RS file location of the file which has been uploaded.\n", - "required": true, - "schema": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n| FILE_SIZE_ERROR | The file is either empty or too large. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.maintainReferralLetter": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to manage the set of 'referral letter' attachments associated with an existing referral, including adding or removing attachments from a referral.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nAll new files to be associated with a referral must be uploaded first using [[HYPERLINK_A020]] and then linked to the referral using this endpoint.\n\n## Important notes\n\nThis endpoint can be used to associate attachments to a referral that has no existing referral letter attachments. \nIn this case you must upload the file first using [[HYPERLINK_A020]] and then associate it to the referral using this endpoint.\n\nYou can also use this endpoint to modify the *set* of referral letter attachments already associated with a referral. \nIn this case, you must post all referral letter attachments you wish to be (finally) associated to the referral, \nincluding any that were already associated. In other words, this endpoint replaces the set of referral letter \nattachments previously associated - with those specified in your latest request. \nAs such, it is imperative that this call references all the attachments the user wishes to keep, every time it is called.\n\nBelow are three example scenarios which clarify the behaviour of the endpoint when referral attachments are already present on the referral:\n\n1. Let us consider a referral that has two referral letter attachments associated (say \"A.pdf\" and \"B.pdf\"). If \nyou wish to add an additional attachment (say \"C.pdf\"), you must upload the additional attachment \n\"C.pdf\" using [[HYPERLINK_A020]], and then associate attachments \"A.pdf\", \"B.pdf\" and \"C.pdf\" \nvia this endpoint in a single request. That is, all three attachments \"A.pdf\", \"B.pdf\" and \"C.pdf\" \nmust be included in the request to [[HYPERLINK_A012]].\n2. Let us consider a different referral that has two referral letter attachments (say \"D.jpg\" and \"E.jpg\") \nalready associated, and you wish to remove one of them. Let us consider that you wish to remove \"D.jpg\". \nTo do this, you would call [[HYPERLINK_A012]] specifying only \"E.jpg\" in your request. By omitting \n\"D.jpg\" from your request, e-RS will disassociate attachment \"D.jpg\" from the referral and only attachment \"E.jpg\" \nwill remain associated.\n3. Let us now consider a referral that has four referral letter attachments associated (say \"L.doc\", \"M.doc\", \"N.doc\" \nand \"O.doc\"), and you wish to add some more files (say \"P.doc\" and \"Q.doc\") and remove some files (say \"N.doc\" \nand \"O.doc\"). To do this you must upload the additional attachment(s) (\"N.doc\" and \"O.doc\") \nusing [[HYPERLINK_A020]]. Following that successful upload, you must then associate only all \nreferral letter attachments the user wishes to keep (namely \"L.doc\", \"M.doc\", \"P.doc\" and \"Q.doc\") \nin a single request to [[HYPERLINK_A012]]. Attachments not included in the request \n(namely \"N.doc\" and \"O.doc\") will be disassociated from the referral as a result.\n\nAs a developer or software supplier, please ensure your users are made aware or protected from this behaviour. \nFor example, when a referring user wants to update the attachments on a referral, the user should be presented \nwith the currently associated attachments so they can add and/or remove attachments as required.\n\nNote: It is not permissible to remove *all* referral letter attachments leaving zero attachments associated. \nThere must be at least one referral letter attachment associated.\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use case\nAs an authenticated user\n\nI need to be able to manage referral letter attachments associated with a referral\n\nSo I can ensure the service provider has enough information to review/process the referral.\n\n\n## Related endpoints\nDocuments must be uploaded into the e-RS document store using [[HYPERLINK_A020]] before they can be associated \nwith a referral.\n\nYou can check to see what referral letter information has been added to a referral by using [[HYPERLINK_A005]], \n[[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment:\n\n| Scenario | Request |\n| ------------------------------------------------------ | ------------------------------------------------------- |\n| Add clinical information for first time (single file) | `ubrn`=`000000070000`, `body` as defined in example 1 |\n| Add clinical information for first time (two files) | `ubrn`=`000000070001`, `body` as defined in example 2 |\n| Update clinical information | `ubrn`=`000000070001`, `body` as defined in example 3 |\n", - "summary": "Maintain referral letter (A012, FHIR STU3)", - "operationId": "a012-maintain-referral-letter", - "tags": [ - "Refer patient", - "Arrange appointment", - "Arrange triage" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-MaintainReferralLetter-Parameters", - "description": "The parameters object used in maintain referral letter endpoint", - "type": "object", - "required": [ - "meta", - "resourceType", - "parameter" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-MaintainReferralLetter-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-MaintainReferralLetter-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `referralLetterFile` | `1..*` | |\n", - "items": { - "title": "referralLetterFile", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "referralLetterFile" - ], - "example": "referralLetterFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER" - ], - "example": "REFERRER" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "Blood test results showing an anomaly in the values of xxxx" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - } - } - } - }, - "examples": { - "single-file": { - "summary": "1 - Add clinical information (single file)", - "value": { - "$ref": "../../examples/maintainReferralLetter/requests/SingleDocumentReference.json" - } - }, - "two-files": { - "summary": "2 - Add clinical information (two files)", - "value": { - "$ref": "../../examples/maintainReferralLetter/requests/MultipleDocumentReferences.json" - } - }, - "update-files": { - "summary": "3 - Update clinical information (removing one file from example above)", - "value": { - "$ref": "../../examples/maintainReferralLetter/requests/UpdateClinicalInfo.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "withClinicalInformation": { - "summary": "`ReferralRequest` with clinical information (2 files)", - "value": { - "$ref": "../../../examples/maintainReferralLetter/responses/ReferralRequestWithMultipleDocumentReferences.json" - } - }, - "withClinicalInformationFirstTime": { - "summary": "`ReferralRequest` with clinical information (1 file)", - "value": { - "$ref": "../../../examples/maintainReferralLetter/responses/ReferralRequestWithSingleDocumentReference.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| NO_CHANGES_DETECTED | No changes detected when processing supplied request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.acceptReferral": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint, as a service provider, to accept a referral that is booked into your bookable service and awaiting review.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n### Application-restricted, unattended access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nTo access this endpoint in application-restricted, unattended mode, you will be required to submit your use case for review.\n\n## Important notes\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications. \n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. [[HYPERLINK_A013]] can only be used for referrals \nbooked into bookable services, and not the referrals sent into triage services.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\n## Use cases\nAs an authenticated user\n\nI need to accept an inbound referral after its review\n\nSo that I can confirm the patient's referral is appropriate for the current service and booked appointment date/time.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Accept referral (A013, FHIR STU3)", - "operationId": "a013-accept-referral", - "tags": [ - "Review referral requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - } - ], - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "example-response": { - "summary": "Example response", - "value": { - "$ref": "../../../examples/acceptReferral/responses/ExampleResponse.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.rejectReferral": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint, as a service provider, to reject a referral that is booked into your bookable service and awaiting review. \nThis returns the referral to the referrer with a mandatory rejection reason and optional user comment to explain why it has been rejected.\n\nConsider using [[HYPERLINK_A022]] instead if you wish to ask your admin team to get the patient into the most appropriate service.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. [[HYPERLINK_A014]] can only \nbe used for referrals booked into bookable services, and not the referrals sent into triage services.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\nYou need to use [[HYPERLINK_A004]] to retrieve a list of rejection reason reference data codes along with their user-friendly display names. To find \nrelevant rejection reasons, obtain reference data from `APPOINTMENT-CANCELLATION-REASON` and filter as follows:\n\n - `appointmentBookingCancellationReasonType` must be `PROVIDER_REJECT`\n - `effectiveFrom` must be in the past, and\n - `effectiveTo` must not be in the past\n\n## Important notes\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use cases\nAs an authenticated user\n\nI need to reject an inbound referral back to the referrer after its review with an explanation of why\n\nSo that the referrer can address the reason for rejection and progress the referral appropriately.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Reject referral (A014, FHIR STU3)", - "operationId": "a014-reject-referral", - "tags": [ - "Review referral requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-RejectReferral-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RejectReferral-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RejectReferral-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `rejectionReason` | `1..1` | The reason why the referral is being rejected |\n| `rejectionComments` | `0..1` | This may be mandatory if mandatory comment indicator is set to 'Yes' for the Rejection Reason Type selected. Maximum 2000 characters. |\n| `appointmentCancelledInPAS` | `0..1` | This flag is mandatory for indirectly bookable services | \n", - "items": { - "anyOf": [ - { - "title": "rejectionReason", - "description": "Parameter to supply a rejectionReason", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "rejectionReason" - ], - "example": "rejectionReason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "TREATMENT_NO_LONGER_REQUIRED" - } - } - } - } - }, - { - "title": "rejectionComments", - "description": "Parameter to supply the rejectionComments", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "rejectionComments" - ], - "example": "rejectionComments" - }, - "valueString": { - "type": "string", - "example": "Condition of the patient has improved. No further action needed" - } - } - }, - { - "title": "appointmentCancelledInPAS", - "description": "Parameter to supply a appointmentCancelledInPAS", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "appointmentCancelledInPAS" - ], - "example": "appointmentCancelledInPAS" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - } - ] - } - } - } - }, - "examples": { - "basic-example-ibs": { - "summary": "Basic example for IBS", - "value": { - "$ref": "../../examples/rejectReferral/requests/BasicExampleIbs.json" - } - }, - "basic-example-dbs": { - "summary": "Basic example for DBS", - "value": { - "$ref": "../../examples/rejectReferral/requests/BasicExampleDbs.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "example-response-ibs": { - "summary": "Example response for IBS", - "value": { - "$ref": "../../../examples/rejectReferral/responses/ExampleResponseIbs.json" - } - }, - "example-response-dbs": { - "summary": "Example response for DBS", - "value": { - "$ref": "../../../examples/rejectReferral/responses/ExampleResponseDbs.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNABLE_TO_CANCEL_APPOINTMENT | System is unable to cancel the appointment. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - }, - "504": { - "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "timeout", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_NOT_RESPONDING", - "display": "No response from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.generatePatientLetter": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to download a PDF format letter for the patient summarising the current state of their referral and any steps the patient may need to follow.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\n## Use case\n\nAs an authenticated user\n\nI need to generate the patient letter including up-to-date details about their referral and any steps the patient may need to follow\n\nSo that I can pass it to the patient.\n", - "summary": "Generate patient letter (A019, FHIR STU3)", - "operationId": "a019-generate-patient-letter", - "tags": [ - "Refer patient", - "Arrange appointment", - "Arrange triage" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "responses": { - "200": { - "description": "Response contains the binary stream of the generated patient letter.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Disposition": { - "description": "The description of the type of content provided.\n", - "required": true, - "schema": { - "type": "string", - "example": "attachment; filename=\"000000070000_Appointment_Confirmation_Summary_20210603121353.pdf\"" - } - }, - "Content-Length": { - "description": "The length of the response.\n", - "required": true, - "schema": { - "type": "string", - "example": "3111" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/pdf" - ], - "example": "application/pdf" - } - } - }, - "content": { - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_ACCESS_CODE | The patient does not have an access code/password to log onto the patient portal. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.cancelAppointmentActionLater": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint, as a service provider, to task your admin team to rebook/redirect a referral that is booked \ninto your bookable service and awaiting review.\n\nNote: this will also cancel the current appointment.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. [[HYPERLINK_A022]] can \nonly be used for referrals booked into bookable services, and not the referrals sent into triage services.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\nIf you want to include attachments with the admin task, you need to use [[HYPERLINK_A020]] so they are \nready to be associated when this endpoint is called.\n\n## Use cases\nAs an authenticated user\n\nI need to task my admin team to rebook/redirect a referral I have reviewed (whilst also cancelling the current appointment)\n\nSo that I can progress the patient's care along the most appropriate referral pathway.\n\n## Important notes\n - The priority of the referral can be changed as part of this endpoint.\n - A comment must be added to explain to the administrator what is required and can include optional attachments.\n - The current appointment is cancelled as part of this endpoint. If the current appointment is booked to an indirectly\n bookable service, you must indicate whether the appointment has been cancelled on the local provider system. \n If indicated as not cancelled, the referral will be added to the 'Indirectly Booked Appointments to Cancel in PAS' \n worklist to task the admin team to do so.\n - When this endpoint is successfully used, an entry will be added to the service providers 'Appointments For Booking' \n worklist for the admin team to action the task. The provider admin team will only be able to progress the referral \n via the e-RS Professional Application user interface (e.g. shortlisting appropriate services for the patient).\n - In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \n The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n - Further details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Cancel appointment, action later (A022, FHIR STU3)", - "operationId": "a022-cancel-appointment-action-later", - "tags": [ - "Review referral requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-cancelAppointmentActionLater-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-cancelAppointmentActionLater-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-cancelAppointmentActionLater-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------------------- |\n| `priority` | `0..1` | Optionally updates the priority |\n| `appointmentCancelledinPAS` | `0..1` | This flag is mandatory for indirectly bookable services |\n| `comments` | `1..1` | |\n| `providerAttachmentFile` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "description": "Parameter to supply a priority", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "appointmentCancelledInPAS", - "description": "Parameter to supply a appointmentCancelledInPAS", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "appointmentCancelledInPAS" - ], - "example": "appointmentCancelledInPAS" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "comments", - "description": "Parameter to supply the comments", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Please contact patient to rebook" - } - } - }, - { - "title": "providerAttachmentFile", - "description": "Parameter to supply an attachment file", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "providerAttachmentFile" - ], - "example": "providerAttachmentFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER" - ], - "example": "PROVIDER" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "basic-example-dbs": { - "summary": "Basic example for DBS", - "value": { - "$ref": "../../examples/cancelAppointmentActionLater/requests/MinimalExampleDBS.json" - } - }, - "example-priority-change-and-attachments": { - "summary": "Example for priority change and attachments", - "value": { - "$ref": "../../examples/cancelAppointmentActionLater/requests/PriorityChangeAndWithAttachmentsDBS.json" - } - }, - "basic-example-ibs": { - "summary": "Basic example for IBS", - "value": { - "$ref": "../../examples/cancelAppointmentActionLater/requests/MinimalExampleIBS.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "example-response-dbs": { - "summary": "Example response for DBS", - "value": { - "$ref": "../../../examples/cancelAppointmentActionLater/responses/MinimalExampleDBS.json" - } - }, - "example-priority-change-and-attachments": { - "summary": "Example response for priority change and attachments", - "value": { - "$ref": "../../../examples/cancelAppointmentActionLater/responses/PriorityChangeAndWithAttachmentsDBS.json" - } - }, - "example-response-ibs": { - "summary": "Example response for IBS", - "value": { - "$ref": "../../../examples/cancelAppointmentActionLater/responses/MinimalExampleIBS.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/CommunicationRequest/$ers.fetchworklist": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve available worklists of advice and guidance requests. Use [[HYPERLINK_A008]] to retrieve available worklists of referral requests.\n\nWorklists provide lists of referral/advice requests that meet certain criteria, typically where a user needs to be aware of something important, \nor to undertake an action, in order to avoid delays to patient care.\n\nService provider organisations can retrieve the contents of their 'Advice and guidance requests' worklist using \nthis endpoint. This worklist contains advice and guidance requests the provider has received and which need actioning. The version of each advice \nrequest 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.\n\nThere are currently no advice and guidance related worklists available for referring organisations.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nIf a worklist response exceeds 10MB, a successful response will not be returned. This is due to the size limitation on the APIM platform.\n\n## Use case\nAs an authenticated user\n\nI need to retrieve a worklist of advice and guidance requests\n\nSo I can determine which ones I need to take further action on.\n\n## Related endpoints\n\nHaving used this endpoint to retrieve the 'Advice and Guidance Requests' worklist, entries from it can be used as follows:\n - Use [[HYPERLINK_A024]] to retrieve contextual summary details of the advice and guidance request\n - Use [[HYPERLINK_A025]] to retrieve the conversation within the advice and guidance request, including references to attachments\n - Use [[HYPERLINK_A006]] to retrieve clinical attachments for an advice and guidance request\n - Use [[HYPERLINK_A026]] to respond to the referrer supplying advice or requesting further information\n - Use [[HYPERLINK_A027]] to convert the advice and guidance request into a referral. This is only possible if the referrer has authorised the provider to do so\n - Use [[HYPERLINK_A043]] to generate a PDF file overview relating to an advice and guidance request\n", - "summary": "Retrieve advice and guidance requests worklist (A023, FHIR STU3)", - "operationId": "a023-retrieve-a&g-worklist", - "tags": [ - "Review advice and guidance requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-FetchWorklist-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `listType` | `1..1` | |\n| `service` | `0..1` | Mandatory for the application-restricted security pattern |\n| `specialtyAssignedIndicator` | `0..1` | |\n| `specialty` | `0..1` | | \n| `location` | `0..1` | | \n| `clinicianAssignedIndicator` | `0..1` | | \n| `clinician` | `0..1` | | \n", - "items": { - "anyOf": [ - { - "title": "listType", - "description": "Indicates the type of list requested", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "listType" - ], - "example": "listType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| -------------------------------- | ----------- | -------------------------------------- |\n| `eRS-ReferralListSelector` | `0..1` | |\n| `eRS-CommunicationListSelector` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-ReferralListSelector", - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralListSelector-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRALS_FOR_REVIEW", - "APPOINTMENT_SLOT_ISSUES", - "REJECTED_TRIAGE_RESPONSE", - "ASSESSMENT_RETURNED_CANCELLED_DNA", - "AWAITING_BOOKING", - "LETTERS_OUTSTANDING" - ], - "example": "REFERRALS_FOR_REVIEW" - } - } - }, - { - "title": "eRS-CommunicationListSelector", - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationListSelector-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVICE_AND_GUIDANCE_REQUESTS" - ], - "example": "ADVICE_AND_GUIDANCE_REQUESTS" - } - } - } - ] - } - } - } - } - } - }, - { - "title": "service", - "description": "The service identifier", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - }, - { - "title": "specialtyAssignedIndicator", - "description": "Indicates whether filtering on Specialty is required or not\n", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialtyAssignedIndicator" - ], - "example": "specialtyAssignedIndicator" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - }, - "code": { - "type": "string", - "enum": [ - "ASSIGNED", - "NOT_ASSIGNED" - ], - "example": "NOT_ASSIGNED" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "location", - "description": "The service location identifier", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "location" - ], - "example": "location" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "clinicianAssignedIndicator", - "description": "Indicates whether filtering on Clinician is required or not\n", - "type": "object", - "required": [ - "name", - "valueCodeableConcept" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicianAssignedIndicator" - ], - "example": "clinicianAssignedIndicator" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssignedIndicator-1" - }, - "code": { - "type": "string", - "enum": [ - "ASSIGNED", - "NOT_ASSIGNED" - ], - "example": "NOT_ASSIGNED" - } - } - } - } - } - } - } - }, - { - "title": "clinician", - "description": "The clinician assigned to the Referral Request. If present, the 'clinicianAssignedIndicator' parameter must be set to 'Assigned'", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinician" - ], - "example": "clinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "aAndg-requests": { - "summary": "Advice and guidance requests", - "value": { - "$ref": "../../examples/retrieveAdviceAndGuidanceWorklist/requests/MinimalAdviceAndGuidanceRequests.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "The response body contains the list of advice and guidance requests (if any) that match the search criteria provided", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-FetchWorklist-List", - "description": "A list of referrals representing the available worklist items", - "type": "object", - "required": [ - "meta", - "resourceType", - "status", - "mode" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-FetchWorklist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------------------------------------------- |\n| `Practitioner` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n| `Patient` | `0..*` | This resource is only contained when fetching the Referrals for Review worklist |\n", - "items": { - "anyOf": [ - { - "title": "Practitioner", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "Practitioner-021600556514" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Practitioner-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Practitioner" - ], - "example": "Practitioner" - }, - "identifier": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - }, - { - "title": "Patient", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "Patient-9912003888" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Patient-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Patient" - ], - "example": "Patient" - }, - "identifier": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with referral details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070002" - } - } - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ----------------------------------------------------------- | ----------- | ------------------------------------------------------------- |\n| `Extension-eRS-ReferralsforReview-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AppointmentSlotIssues-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested | \n| `Extension-eRS-AdviceAndGuidanceRequests-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-RejectedTriageResponse-WorkListItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-AwaitingBooking-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n| `Extension-eRS-LettersOutstanding-WorklistItem` | `0..1` | Type of worklist items depends on the worklist type requested |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralsforReview-WorkListItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralsforReview-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `requestContextStatus` | `1..1` | |\n| `clinicalInfoFirstSubmitted` | `0..1` | |\n| `clinicalInfoLastUpdated` | `0..1` | |\n| `appointmentStart` | `0..1` | |\n| `allocatedClinician` | `0..1` | |\n| `service` | `1..1` | |\n| `referralRequestVersion` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#Patient-9462979626" - } - } - } - } - }, - { - "title": "namedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#Practitioner-021600556514" - } - } - } - } - }, - { - "title": "eReferralPathwayStart", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "eReferralPathwayStart" - ], - "example": "eReferralPathwayStart" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "clinicalInfoPrinted", - "type": "object", - "required": [ - "url", - "valueBoolean" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoPrinted" - ], - "example": "clinicalInfoPrinted" - }, - "valueBoolean": { - "type": "boolean", - "example": false - } - } - }, - { - "title": "requestContextStatus", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "requestContextStatus" - ], - "example": "requestContextStatus" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-RequestContextStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "LETTER_CHANGED", - "PRIORITY_CHANGED", - "PRIORITY_AND_LETTER_CHANGED", - "NEVER_REVIEWED" - ], - "example": "NEVER_REVIEWED" - }, - "display": { - "type": "string", - "example": "Never Reviewed" - } - } - } - } - } - } - } - }, - { - "title": "clinicalInfoFirstSubmitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoFirstSubmitted" - ], - "example": "clinicalInfoFirstSubmitted" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "clinicalInfoLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoLastUpdated" - ], - "example": "clinicalInfoLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-03T10:44:42.764Z" - } - } - }, - { - "title": "referralType", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralType" - ], - "example": "referralType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralType-1" - }, - "code": { - "type": "string", - "enum": [ - "APPOINTMENT", - "TRIAGE_DEFERRAL" - ], - "example": "TRIAGE_DEFERRAL" - } - } - } - } - } - } - } - }, - { - "title": "appointmentStart", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "appointmentStart" - ], - "example": "appointmentStart" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-02T14:15:00.000Z" - } - } - }, - { - "title": "allocatedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "allocatedClinician" - ], - "example": "allocatedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#Practitioner-021600556514" - } - } - } - } - }, - { - "title": "service", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Service Name" - } - } - } - } - }, - { - "title": "referralRequestVersion", - "type": "object", - "required": [ - "url", - "valueInteger" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralRequestVersion" - ], - "example": "referralRequestVersion" - }, - "valueInteger": { - "type": "integer", - "example": 0 - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AppointmentSlotIssues-WorkListItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AppointmentSlotIssues-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `eReferralPathwayStart` | `1..1` | |\n| `clinicalInfoPrinted` | `1..1` | |\n| `ubrnReceived` | `0..1` | |\n| `patientContactExpected` | `0..1` | |\n| `clinicalInformationStatus` | `0..1` | |\n| `reason` | `0..1` | |\n| `lastContact` | `0..1` | |\n| `service` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "namedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "eReferralPathwayStart", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "eReferralPathwayStart" - ], - "example": "eReferralPathwayStart" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "clinicalInfoPrinted", - "type": "object", - "required": [ - "url", - "valueBoolean" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInfoPrinted" - ], - "example": "clinicalInfoPrinted" - }, - "valueBoolean": { - "type": "boolean", - "example": false - } - } - }, - { - "title": "ubrnReceived", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "ubrnReceived" - ], - "example": "ubrnReceived" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "patientContactExpected", - "type": "object", - "required": [ - "url", - "valueDate" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patientContactExpected" - ], - "example": "patientContactExpected" - }, - "valueDate": { - "type": "string", - "format": "date", - "example": "2021-09-07" - } - } - }, - { - "title": "clinicalInformationStatus", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalInformationStatus" - ], - "example": "clinicalInformationStatus" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicalInformationStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PRESENT", - "NOT_APPLICABLE", - "NOT_DUE", - "OVERDUE" - ], - "example": "NOT_DUE" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - } - } - } - } - } - }, - { - "title": "lastContact", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "lastContact" - ], - "example": "lastContact" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "service", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Service Name" - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AdviceAndGuidanceRequests-WorkListItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AdviceAndGuidanceRequests-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | ------------------------------------------ |\n| `priority` | `1..1` | |\n| `specialty` | `1..1` | |\n| `patient` | `1..1` | |\n| `namedClinician` | `0..1` | |\n| `category` | `1..1` | |\n| `adviceFirstRequested` | `1..1` | |\n| `adviceLastUpdated` | `1..1` | |\n| `referrer` | `1..1` | |\n| `service` | `1..1` | |\n| `clinicType` | `0..1` | |\n| `communicationRequestVersion` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "specialty", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - } - } - } - }, - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "namedClinician", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "category", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "category" - ], - "example": "category" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_RESPONSE_REQUIRED", - "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", - "REFERRER_TO_REVIEW_RESPONSE", - "CONVERSATION_ENDED_CANCELLED", - "CONVERSATION_ENDED_CLOSED", - "ADVICE_CONVERTED" - ], - "example": "PROVIDER_RESPONSE_REQUIRED" - } - } - } - } - } - } - } - }, - { - "title": "adviceFirstRequested", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "adviceFirstRequested" - ], - "example": "adviceFirstRequested" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "adviceLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "adviceLastUpdated" - ], - "example": "adviceLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "adviceLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "adviceLastUpdated" - ], - "example": "adviceLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-09-01T14:26:18.314Z" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "service", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "service" - ], - "example": "service" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier", - "display" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Service Name" - } - } - } - } - }, - { - "title": "clinicType", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/CLINIC-TYPE" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - } - } - } - }, - { - "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": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-RejectedTriageResponse-WorkListItem-1" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Rejected/TriageRequest worklist, only included if `status` is `TRIAGE_RESPONSE` |\n", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "referralLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLastUpdated" - ], - "example": "referralLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "status", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "status" - ], - "example": "status" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "ASSESSMENT_RESULT", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "NOT_BOOKED", - "BOOKED", - "AWAITING_TRIAGE", - "DEFERRED_TO_PROVIDER", - "APP_CANCELLED_BY_PROVIDER", - "APP_CANCELLED_BY_PATIENT", - "TRIAGED_PROVIDER_TO_ACTION", - "TRIAGE_RESPONSE" - ], - "example": "REJECTED" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Assessment result", - "Cancelled referral", - "Did not attend", - "Not booked", - "Booked", - "Awaiting triage", - "Deferred to provider", - "Appointment cancelled by provider", - "Appointment cancelled by patient", - "Triaged - provider to action", - "Triage Response" - ], - "example": "Rejected" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - ], - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "FURTHER_INFORMATION_REQUIRED" - }, - "display": { - "type": "string", - "example": "Further information required" - } - } - } - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AssessmentReturnedCancelledDna-WorklistItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AssessmentReturnedCancelledDna-WorkListItem-1" - }, - "extension": { - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Assessment Returned / Cancelled / DNA worklist, only included if `status` is `CANCELLED_REFERRAL` |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "referralLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLastUpdated" - ], - "example": "referralLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "status", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "status" - ], - "example": "status" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "ASSESSMENT_RESULT", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "NOT_BOOKED", - "BOOKED", - "AWAITING_TRIAGE", - "DEFERRED_TO_PROVIDER", - "APP_CANCELLED_BY_PROVIDER", - "APP_CANCELLED_BY_PATIENT", - "TRIAGED_PROVIDER_TO_ACTION", - "TRIAGE_RESPONSE" - ], - "example": "REJECTED" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Assessment result", - "Cancelled referral", - "Did not attend", - "Not booked", - "Booked", - "Awaiting triage", - "Deferred to provider", - "Appointment cancelled by provider", - "Appointment cancelled by patient", - "Triaged - provider to action", - "Triage Response" - ], - "example": "Rejected" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" - ], - "example": "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "INTEND_PRIVATE" - }, - "display": { - "type": "string", - "example": "Patient will go to a private clinic" - } - } - } - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-AwaitingBooking-WorklistItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AwaitingBooking-WorkListItem-1" - }, - "extension": { - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `referralLastUpdated` | `1..1` | The `dateTime` the `ReferralRequest` was last updated |\n| `status` | `1..1` | The status of the `ReferralRequest` |\n| `reason` | `0..1` | The reason the `ReferralRequest` is on the Awaiting Booking worklist, only included if `status` is `APPOINTMENT_CANCELLED_BY_PROVIDER` or `APPOINTMENT_CANCELLED_BY_PATIENT` |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "referralLastUpdated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralLastUpdated" - ], - "example": "referralLastUpdated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "status", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "status" - ], - "example": "status" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "ASSESSMENT_RESULT", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "NOT_BOOKED", - "BOOKED", - "AWAITING_TRIAGE", - "DEFERRED_TO_PROVIDER", - "APP_CANCELLED_BY_PROVIDER", - "APP_CANCELLED_BY_PATIENT", - "TRIAGED_PROVIDER_TO_ACTION", - "TRIAGE_RESPONSE" - ], - "example": "REJECTED" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Assessment result", - "Cancelled referral", - "Did not attend", - "Not booked", - "Booked", - "Awaiting triage", - "Deferred to provider", - "Appointment cancelled by provider", - "Appointment cancelled by patient", - "Triaged - provider to action", - "Triage Response" - ], - "example": "Rejected" - } - } - } - } - } - } - } - }, - { - "title": "reason", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - ], - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_APPOINTMENT_CLASH" - }, - "display": { - "type": "string", - "example": "Patient - Clashes with another appointment" - } - } - } - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-LettersOutstanding-WorklistItem", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-LettersOutstanding-WorkListItem-1" - }, - "extension": { - "description": "| Field | Cardinality | Notes |\n| ------------------------------ | ----------- | -------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient associated with the `ReferralRequest` |\n| `priority` | `1..1` | The priority associated with the `ReferralRequest` |\n| `referralCreated` | `1..1` | The Date and Time the `ReferralRequest` was initiated |\n| `clinicalContext` | `1..1` | The clinical context for the `ReferralRequest` |\n| `referrer` | `1..1` | The `Practitioner` who initially creates the `ReferralRequest` |\n| `letterDue` | `1..1` | The `date` a referral letter is due for the `ReferralRequest` |\n", - "type": "array", - "items": { - "anyOf": [ - { - "title": "patient", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - { - "title": "priority", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "referralCreated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referralCreated" - ], - "example": "referralCreated" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-11-24T14:46:01.001Z" - } - } - }, - { - "title": "clinicalContext", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "clinicalContext" - ], - "example": "clinicalContext" - }, - "valueString": { - "type": "string", - "example": "ORTHAPEDICS/KNEE" - } - } - }, - { - "title": "referrer", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "referrer" - ], - "example": "referrer" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "letterDue", - "type": "object", - "required": [ - "url", - "valueDate" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "letterDue" - ], - "example": "letterDue" - }, - "valueDate": { - "type": "string", - "format": "date", - "example": "2021-11-24" - } - } - } - ] - } - } - } - } - ] - } - } - } - } - } - } - }, - "examples": { - "aAndg-requests": { - "summary": "Advice and guidance requests", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceWorklist/responses/AdviceAndGuidanceRequests.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request or service. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/CommunicationRequest/{ubrn}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve the summary of an advice and guidance request. This endpoint provides important \ncontextual information about the advice and guidance request (e.g. the service/specialty to which advice has been requested, etc).\n\nThis does not include the advice and guidance conversation between the referrer and the service provider. The conversation must be retrieved via [[HYPERLINK_A025]].\n\nAn advice request can include file attachments and structured clinical data added via an integrated primary care system. These must be retrieved via [[HYPERLINK_A042]] and [[HYPERLINK_A043]], respectively.\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of the advice and guidance request. \nFor service provider users, you may have identified the UBRN via [[HYPERLINK_A023]].\n \n## Application-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n## Healthcare worker, user-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve the summary of an advice and guidance request\n\nSo I can understand all of the relevant context for the request.\n\n## Important notes\n\nThe summary includes an indicator of whether the referrer has authorised the providing organisation to \nconvert the advice and guidance request into an appointment request. \nIf authorised, [[HYPERLINK_A027]] can be used to convert the advice and guidance request into an appointment request.\n\nAn advice and guidance request may have been converted to a referral (with the same UBRN), \nand in addition a referral pathway in e-RS can be made up of more than one UBRN. As such, \nit is important that all clinical information is obtained across all the related UBRNs in the pathway. \nThese may be identified using [[HYPERLINK_A005]] and will be returned if the user is authorised to view this.\n\nIf the converted advice and guidance request is referred to a service outside of your organisation, \nthe subsequent referral information may not be accessible due to existing data-access rules. However, \nthe advice and guidance summary ([[HYPERLINK_A024]]), attachments ([[HYPERLINK_A006]]), advice and guidance conversation ([[HYPERLINK_A025]]) and \nclinical information ([[HYPERLINK_A043]]) which took place before such a conversion still forms part of the clinical information and can still be retrieved.\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or [[HYPERLINK_A006]] endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A024]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE\t | The file is available for download. |\n| PENDING\t | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. |\n| THREATS_FOUND\t | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n## Related endpoints\n\nAfter using this endpoint, use [[HYPERLINK_A025]] to retrieve the Advice and Guidance conversation itself.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ----------------------- |\n| Simple summary `CommunicationRequest` | `ubrn`=`000000070000` |\n| Attachment file reference present | `ubrn`=`000000070001` |\n| Attachment files unavailable for download | `ubrn`=`000000070002` |\n", - "summary": "Retrieve advice and guidance request summary (A024, FHIR STU3)", - "operationId": "a024-retrieve-advice-and-guidance", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "e-RS Communication Request (advice and guidance summary)", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CommunicationRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "category", - "subject", - "recipient", - "sender", - "requester", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "CommunicationRequest" - ], - "example": "CommunicationRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - }, - { - "title": "CareConnect-PractitionerRole", - "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "practitioner", - "organization" - ], - "properties": { - "id": { - "type": "string", - "example": "PractitionerRole-R69-000000000101" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "PractitionerRole" - ], - "example": "PractitionerRole" - }, - "practitioner": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "organization": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - "code": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ProviderConversionAuthorisation", - "description": "Extension to supply the conversion authorisation flag", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - }, - "code": { - "type": "string", - "enum": [ - "AUTHORISED_TO_CONVERT", - "NOT_AUTHORISED_TO_CONVERT" - ], - "example": "NOT_AUTHORISED_TO_CONVERT" - }, - "display": { - "type": "string", - "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" - } - } - } - } - }, - { - "title": "Extension-eRS-Specialty", - "description": "Extension to supply the specialty", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "category": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_RESPONSE_REQUIRED", - "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", - "REFERRER_TO_REVIEW_RESPONSE", - "CONVERSATION_ENDED_CANCELLED", - "CONVERSATION_ENDED_CLOSED", - "ADVICE_CONVERTED" - ], - "example": "PROVIDER_RESPONSE_REQUIRED" - } - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "recipient": { - "type": "array", - "items": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - } - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "requester": { - "type": "object", - "required": [ - "agent" - ], - "properties": { - "agent": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70002" - } - } - } - } - } - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "minimal": { - "summary": "Minimal `CommunicationRequest` example", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/MinimalExample.json" - } - }, - "with-attachment-file-reference": { - "summary": "`CommunicationRequest` with attachment file reference", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithAttachmentFileReference.json" - } - }, - "with-unavailable-attachments": { - "summary": "`CommunicationRequest` with attachments unavailable for download", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithUnavailableAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an Advice and Guidance request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/CommunicationRequest/{ubrn}/_history/{version}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to retrieve a specific version of `CommunicationRequest`.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nThe pre-requisites for this endpoint are the same as for endpoint [[HYPERLINK_A024]].\n\nNote: e-RS only supports the retrieval of the most recent version of `CommunicationRequest`. You cannot retrieve earlier versions.\n\n## Important note\n\nThe Important notes for this endpoint are the same as for endpoint [[HYPERLINK_A024]].\n\n## Use case\n\nSee [[HYPERLINK_A005]].\n\n## Related endpoints\n\nSee [[HYPERLINK_A024]].\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| ------------------------------------------------------------------------ | ------------------------------------- |\n| Simple summary `CommunicationRequest` | `ubrn`=`000000070000`, `version`=`5` |\n| Attachment file reference present | `ubrn`=`000000070001`, `version`=`5` |\n| `CommunicationRequest` with attachments unavailable for download | `ubrn`=`000000070002`, `version`=`5` |\n", - "summary": "Retrieve advice and guidance request summary (versioned) (A024, FHIR STU3)", - "operationId": "a024-retrieve-advice-and-guidance-versioned", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "name": "version", - "in": "path", - "description": "The version of the resource to be retrieved. It must be the latest version of the resource otherwise\n`HISTORY_NOT_SUPPORTED` error will be returned (HTTP 404 Not Found).\n", - "required": true, - "schema": { - "type": "string", - "example": "5" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "e-RS Communication Request (advice and guidance summary)", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CommunicationRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "category", - "subject", - "recipient", - "sender", - "requester", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "CommunicationRequest" - ], - "example": "CommunicationRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - }, - { - "title": "CareConnect-PractitionerRole", - "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "practitioner", - "organization" - ], - "properties": { - "id": { - "type": "string", - "example": "PractitionerRole-R69-000000000101" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "PractitionerRole" - ], - "example": "PractitionerRole" - }, - "practitioner": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "organization": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - "code": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ProviderConversionAuthorisation", - "description": "Extension to supply the conversion authorisation flag", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - }, - "code": { - "type": "string", - "enum": [ - "AUTHORISED_TO_CONVERT", - "NOT_AUTHORISED_TO_CONVERT" - ], - "example": "NOT_AUTHORISED_TO_CONVERT" - }, - "display": { - "type": "string", - "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" - } - } - } - } - }, - { - "title": "Extension-eRS-Specialty", - "description": "Extension to supply the specialty", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "category": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_RESPONSE_REQUIRED", - "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", - "REFERRER_TO_REVIEW_RESPONSE", - "CONVERSATION_ENDED_CANCELLED", - "CONVERSATION_ENDED_CLOSED", - "ADVICE_CONVERTED" - ], - "example": "PROVIDER_RESPONSE_REQUIRED" - } - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "recipient": { - "type": "array", - "items": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - } - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "requester": { - "type": "object", - "required": [ - "agent" - ], - "properties": { - "agent": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70002" - } - } - } - } - } - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "minimal": { - "summary": "Minimal `CommunicationRequest` example", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/MinimalExample.json" - } - }, - "with-attachment-file-reference": { - "summary": "`CommunicationRequest` with attachment file reference", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithAttachmentFileReference.json" - } - }, - "with-unavailable-attachments": { - "summary": "`CommunicationRequest` with attachments unavailable for download", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceRequest/responses/WithUnavailableAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found - Resource not found for ID provided or Resource version does not match version requested." - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an Advice and Guidance request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Communication": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve the advice and guidance conversation between the referring organisation \nand service providing organisation.\n\nA conversation takes the form of messages between a referrer (seeking advice) and a provider or specialist. Messages can include file attachments. These must be retrieved via [[HYPERLINK_A042]]\n\n[Read](https://digital.nhs.uk/developer/guides-and-documentation/building-healthcare-software/referrals-and-bookings/e-referral-service/retrieve-clinical-referral-information-as-a-service-provider) our building healthcare software guide for detailed information.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of the advice and guidance request. For service provider users, \nyou may have identified the UBRN via [[HYPERLINK_A023]].\n\nYou need to use [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request. \nThis will importantly include the latest version of the request which must be used.\n\n## Application-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n## Healthcare worker, user-restricted access\n\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve the conversation that is present on an advice and guidance request\n\nSo that I can review the conversation and potentially contribute further to it.\n\n## Important notes\n\nThe conversation returned includes links to any attachments associated with the conversation.\nThis can be done via endpoint [[HYPERLINK_A006]]. \nNote, dependent on how attachments were added they may be linked to the Advice and Guidance summary instead of the conversation. \nThese may be retrieved from [[HYPERLINK_A024]].\n\nIf the converted advice and guidance request is referred to a service outside of your organisation, \nthe subsequent referral information may not be accessible due to existing data-access rules. \nHowever, the advice and guidance summary ([[HYPERLINK_A024]]), attachments ([[HYPERLINK_A006]]), \nadvice and guidance conversation ([[HYPERLINK_A025]]) and \nclinical information ([[HYPERLINK_A043]]) which took place before such a conversion still forms part of the clinical information and can still be retrieved.\nThe conversation also gets included in the form of a PDF file returned by [[HYPERLINK_A007]].\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. Attachments are only made available once an uploaded file has been validated and successfully malware scanned. A request to retrieve an attachment that is not available for download will result in an error being returned. See [[HYPERLINK_A042]] for more information.\n\nThe availability status of an attachment can be retrieved via any endpoint that returns an eRS-AvailabilityStatus-1 code in the success response, including [[HYPERLINK_A025]]. The eRS-AvailabilityStatus-1 code can return one of four possible values, as detailed below.\n\n| eRS-AvailabilityStatus-1 code | Description / Guidance |\n|-------------------------------|--------------------------------------------------------------------------------------------------------------------|\n| AVAILABLE\t | The file is available for download. |\n| PENDING\t | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. |\n| THREATS_FOUND\t | The file has been quarantined after detecting a threat and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. |\n| VALIDATION_FAILED | The file has failed validation and cannot be retrieved.
Contact the organisation that uploaded the file to resolve the issue and get the information you need. Use the extensions returned via this endpoint: Extension-eRS-AttachedBy-1 and Extension-eRS-AttachedByOrganisation-1. Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS.
|\n\n\n\n## Related endpoints\n\nAfter using this endpoint:\n - Use [[HYPERLINK_A006]] to retrieve any attachments associated with the advice and guidance request.\n - (For service provider users) Use [[HYPERLINK_A026]] to respond to the referrer supplying advice or requesting further information.\n - (For service provider users) Use [[HYPERLINK_A027]] to convert the advice and guidance request into a referral. This is only possible if the referrer has authorised the provider to do so.\n\nUse [[HYPERLINK_A043]] to generate a PDF file overview relating to an advice and guidance request.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| -------------------------------------------------------------- | --------------------------------------------------------- |\n| Single message from referrer | `based-on`=`CommunicationRequest/000000070000/_history/1` |\n| One message each way | `based-on`=`CommunicationRequest/000000070000/_history/2` |\n| Attachment present in each direction | `based-on`=`CommunicationRequest/000000070001/_history/6` |\n| Multi-way conversation | `based-on`=`CommunicationRequest/000000070002/_history/1` |\n| Attachment uploaded from RCS before A&G creation | `based-on`=`CommunicationRequest/000000070003/_history/7` | \n| Attachment files unavailable for download | `based-on`=`CommunicationRequest/000000070004/_history/3` | \n", - "summary": "Retrieve advice and guidance conversation (A025, FHIR STU3)", - "operationId": "a025-retrieve-advice-and-guidance-conversation", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "name": "based-on", - "in": "query", - "description": "The component describing the CommunicationRequest for which the communication is requested for.\n\nPattern:\n\n`CommunicationRequest/{ubrn}/_history/{version}`\n\n - The `ubrn` represents the unique booking reference number of the Advice and Guidance Request for which the caller is obtaining the 'Advice and Guidance Conversation'\n - The `version` is the version of the A&G Request to be retrieved (only the most current version will be retrievable)\n", - "required": true, - "schema": { - "type": "string", - "example": "CommunicationRequest/000000070000/_history/1" - } - }, - { - "in": "query", - "name": "_include", - "description": "Suppliers must request includes they rely on. The default includes behaviour is subject to change. \n\nPlease note that '_include' query parameter can be supplied multiple times for example:\n\n`GET /STU3/Communication\n?based-on=CommunicationRequest/{ubrn}/_history/{version}\n&_include=Communication:requester-practitionerrole:PractitionerRole\n&_include=Communication:sender-practitionerrole:PractionerRole\n&_include=Communication:content-reference:DocumentReference`\n", - "required": false, - "schema": { - "type": "string", - "enum": [ - "Communication:requester-practitionerrole:PractitionerRole", - "Communication:sender-practitionerrole:PractionerRole", - "Communication:content-reference:DocumentReference" - ], - "example": "Communication:requester-practitionerrole:PractitionerRole" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "e-RS Communication Request (advice and guidance summary)", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "Bundle resource containing advice and guidance conversation", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "type", - "total", - "link", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "08acc887-6a7b-4b38-8f50-022e41319efe" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated", - "profile" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" - ], - "example": "http://hl7.org/fhir/STU3/StructureDefinition/Bundle" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Bundle" - ], - "example": "Bundle" - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "total": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 3 - }, - "link": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/STU3/Communication?based-on=CommunicationRequest%2F000000070000%2F_history%2F6&_include=Communication%3Arequester-practitionerrole%3APractitionerRole&_include=Communication%3Asender-practitionerrole%3APractionerRole&_include=Communication%3Acontent-reference%3ADocumentReference" - } - } - } - }, - "entry": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ----------------------- | ----------- | --------------------------------------------------- |\n| `CommunicationEntry` | `1..*` | |\n| `PractitionerRoleEntry` | `2..*` | |\n| `DocumentEntry` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "CommunicationEntry", - "description": "CommunicationEntry details a single chat entry.\n", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/STU3/Communication/70000" - }, - "resource": { - "title": "eRS-Communication-1", - "description": "A record of information transmitted from a sender to a receiver", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "category", - "recipient", - "sent", - "sender", - "note" - ], - "properties": { - "id": { - "type": "string", - "example": "appointment" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/eRS-Communication-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Communication" - ], - "example": "Communication" - }, - "status": { - "type": "string", - "enum": [ - "completed" - ], - "example": "completed" - }, - "category": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" - }, - "code": { - "type": "string", - "enum": [ - "REQUESTER", - "RESPONDER", - "REFERRER_CLINICAL_INFORMATION_UPDATED" - ], - "example": "REQUESTER" - } - } - } - } - } - } - }, - "recipient": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - }, - { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - ] - } - }, - "sent": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "DocumentReference/70000" - } - } - } - } - } - }, - "note": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "text" - ], - "properties": { - "text": { - "type": "string", - "example": "Example content...", - "description": "Maximum 8000 characters." - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - } - } - }, - { - "title": "PractitionerRoleEntry", - "description": "PractitionerRoleEntry details practitioner involved in this conversation.\n", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/STU3/PractitionerRole/103264994981.R69.SERVICE-PROVIDER-CLINICIAN" - }, - "resource": { - "title": "CareConnect-PractitionerRole", - "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "practitioner", - "organization" - ], - "properties": { - "id": { - "type": "string", - "example": "PractitionerRole-R69-000000000101" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "PractitionerRole" - ], - "example": "PractitionerRole" - }, - "practitioner": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "organization": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - "code": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "include" - ], - "example": "include" - } - } - } - } - }, - { - "title": "DocumentEntry", - "description": "DocumentEntry contains the 'DocumentReference' associated with this advice and guidance conversation.\n", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/STU3/DocumentReference/70000" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "include" - ], - "example": "include" - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "single-message-from-referrer": { - "summary": "Single message from referrer", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/SingleMessageFromReferrer.json" - } - }, - "one-message-each-way": { - "summary": "One message each way", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/OneMessageEachWay.json" - } - }, - "attachment-present-in-each-direction": { - "summary": "Attachment present in each direction", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/AttachmentPresentInEachDirection.json" - } - }, - "multi-way-conversation": { - "summary": "Multi-way conversation", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/MultiWayConversation.json" - } - }, - "attachment-uploaded-from-rcs": { - "summary": "Attachment uploaded from RCS", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/AttachmentUploadedFromRCS.json" - } - }, - "unavailable-attachments": { - "summary": "Attachment files unavailable for download", - "value": { - "$ref": "../../../examples/retrieveAdviceAndGuidanceConversation/UnavailableAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found - Resource not found for ID provided or Resource version does not match version requested." - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/CommunicationRequest/{ubrn}/$ers.sendCommunicationToRequester": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint, as a service provider, to respond to an advice and guidance request your service provider organisation has received. \nYou can either provide guidance back to the referrer or request further information from the referrer. \nThis will return the advice and guidance request back to the referrer for action.\n\nNote: If you want to convert an advice and guidance request into a referral, \nand provide a final guidance response back to the referrer at the same time, please \nuse [[HYPERLINK_A027]] instead. This option is only permissible \nif the referrer has authorised the provider to convert the advice and guidance request into a referral.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request.\n\nYou need to use [[HYPERLINK_A025]] to retrieve the conversation within an advice and guidance request.\n\nIf you want to include attachments with the response, you need to use [[HYPERLINK_A020]] so they are ready to be associated with the response.\n\n## Important notes\n \nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download.\nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n \nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use case\nAs an authenticated user\n\nI need to return an advice and guidance request back to the referrer with some guidance\n\nSo that I can progress the conversation regarding the patient's care.\n\n## Related endpoints\n\nYou can use [[HYPERLINK_A007]] to generate a PDF file that summarises \nthe advice and guidance request and associated conversation.\n\nYou can use [[HYPERLINK_A024]] to retrieve the latest summary of the advice and guidance request.\n\nYou can use [[HYPERLINK_A025]] to retrieve the latest conversation within the advice and guidance request.\n", - "summary": "Send advice and guidance response (A026, FHIR STU3)", - "operationId": "a026-send-a&g-response", - "tags": [ - "Review advice and guidance requests" - ], - "parameters": [ - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-SendCommunicationToRequester-Request-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Request-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Request-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------------------------------------------------ |\n| `guidanceOutcome` | `1..1` | |\n| `guidanceIntendedRecommendation` | `0..1` | Conditionally Mandatory if guidanceOutcome value is `RETURN_TO_REFERRER_WITH_ADVICE` |\n| `guidance` | `1..1` | Mandatory guidance response. Maximum 8000 characters. |\n| `updatedPriority` | `1..1` | | \n| `guidanceAttachmentFile` | `0..*` | Property defining files to be included with the supplied `guidance` text | \n", - "items": { - "anyOf": [ - { - "title": "guidanceOutcome", - "description": "Parameter indicating the expected outcome of the supplied guidance", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "guidanceOutcome" - ], - "example": "guidanceOutcome" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceResponseOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceResponseOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "RETURN_TO_REFERRER_WITH_ADVICE", - "REQUIRE_FURTHER_INFORMATION", - "PROVIDER_CONVERTED" - ], - "example": "RETURN_TO_REFERRER_WITH_ADVICE" - } - } - } - } - }, - { - "title": "guidanceIntendedRecommendation", - "description": "Parameter to supply the recommendation for a patient's care off the back of the provided guidance. Only available and mandatory when supplying a `guidanceOutcome` of `RETURN_TO_REFERRER_WITH_ADVICE`", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "guidanceIntendedRecommendation" - ], - "example": "guidanceIntendedRecommendation" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceIntendedRecommendation-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-GuidanceIntendedRecommendation-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVICE_ONLY_NO_REFERRAL_RECOMMENDED", - "ADVICE_FOLLOWED_BY_REFERRAL_IF_REQUIRED", - "REFERRAL_RECOMMENDED", - "OTHER" - ], - "example": "ADVICE_ONLY_NO_REFERRAL_RECOMMENDED" - } - } - } - } - }, - { - "title": "guidance", - "description": "Parameter to supply the guidance", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "guidance" - ], - "example": "guidance" - }, - "valueString": { - "type": "string", - "example": "Please perform test B and send me back the results" - } - } - }, - { - "title": "updatedPriority", - "description": "Parameter to supply a updatedPriority", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "updatedPriority" - ], - "example": "updatedPriority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "guidanceAttachmentFile", - "description": "Parameter to supply an attachment file", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "guidanceAttachmentFile" - ], - "example": "guidanceAttachmentFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "GUIDANCE_RESPONSE" - ], - "example": "GUIDANCE_RESPONSE" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "require-further-information": { - "summary": "Require further information", - "value": { - "$ref": "../../examples/sendAdviceAndGuidanceResponse/requests/RequireFurtherInformation.json" - } - }, - "return-to-referrer-with-advice": { - "summary": "Return to referrer with advice", - "value": { - "$ref": "../../examples/sendAdviceAndGuidanceResponse/requests/ReturnToReferrerWithAdvice.json" - } - }, - "attachment-included": { - "summary": "Attachment included", - "value": { - "$ref": "../../examples/sendAdviceAndGuidanceResponse/requests/AttachmentIncluded.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Parameters resource containing updated communication request and newly created communication", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-SendCommunicationToRequester-Response-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Response-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-SendCommunicationToRequester-Response-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `updatedCommunicationRequest` | `1..1` | |\n| `createdCommunication` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "updatedCommunicationRequest", - "description": "Parameter containing the updated `CommunicationRequest` detailing changes to the overall conversation (changes to priority, status, etc)", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "updatedCommunicationRequest" - ], - "example": "updatedCommunicationRequest" - }, - "resource": { - "title": "eRS-CommunicationRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "category", - "subject", - "recipient", - "sender", - "requester", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "CommunicationRequest" - ], - "example": "CommunicationRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - }, - { - "title": "CareConnect-PractitionerRole", - "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "practitioner", - "organization" - ], - "properties": { - "id": { - "type": "string", - "example": "PractitionerRole-R69-000000000101" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "PractitionerRole" - ], - "example": "PractitionerRole" - }, - "practitioner": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "organization": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - "code": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ProviderConversionAuthorisation", - "description": "Extension to supply the conversion authorisation flag", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - }, - "code": { - "type": "string", - "enum": [ - "AUTHORISED_TO_CONVERT", - "NOT_AUTHORISED_TO_CONVERT" - ], - "example": "NOT_AUTHORISED_TO_CONVERT" - }, - "display": { - "type": "string", - "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" - } - } - } - } - }, - { - "title": "Extension-eRS-Specialty", - "description": "Extension to supply the specialty", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "category": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_RESPONSE_REQUIRED", - "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", - "REFERRER_TO_REVIEW_RESPONSE", - "CONVERSATION_ENDED_CANCELLED", - "CONVERSATION_ENDED_CLOSED", - "ADVICE_CONVERTED" - ], - "example": "PROVIDER_RESPONSE_REQUIRED" - } - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "recipient": { - "type": "array", - "items": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - } - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "requester": { - "type": "object", - "required": [ - "agent" - ], - "properties": { - "agent": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70002" - } - } - } - } - } - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - } - } - }, - { - "title": "createdCommunication", - "description": "Parameter containing the newly created `Communication` detailing the guidance provided", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "createdCommunication" - ], - "example": "createdCommunication" - }, - "resource": { - "title": "eRS-Communication-1", - "description": "A record of information transmitted from a sender to a receiver", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "category", - "recipient", - "sent", - "sender", - "note" - ], - "properties": { - "id": { - "type": "string", - "example": "appointment" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/eRS-Communication-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Communication" - ], - "example": "Communication" - }, - "status": { - "type": "string", - "enum": [ - "completed" - ], - "example": "completed" - }, - "category": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" - }, - "code": { - "type": "string", - "enum": [ - "REQUESTER", - "RESPONDER", - "REFERRER_CLINICAL_INFORMATION_UPDATED" - ], - "example": "REQUESTER" - } - } - } - } - } - } - }, - "recipient": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - }, - { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - ] - } - }, - "sent": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "DocumentReference/70000" - } - } - } - } - } - }, - "note": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "text" - ], - "properties": { - "text": { - "type": "string", - "example": "Example content...", - "description": "Maximum 8000 characters." - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "require-further-information": { - "summary": "Response for 'Require further information'", - "value": { - "$ref": "../../../examples/sendAdviceAndGuidanceResponse/responses/RequireFurtherInformation.json" - } - }, - "return-to-referrer-with-advice": { - "summary": "Response for 'Return to referrer with advice'", - "value": { - "$ref": "../../../examples/sendAdviceAndGuidanceResponse/responses/ReturnToReferrerWithAdvice.json" - } - }, - "with-attachment": { - "summary": "Response with attachment", - "value": { - "$ref": "../../../examples/sendAdviceAndGuidanceResponse/responses/AttachmentIncluded.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNSUPPORTED_PRIORITY | The Priority submitted is not supported by the responsible Service. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/$ers.createFromCommunicationRequestActionLater": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint, as a service provider, to:\n - convert the advice and guidance request you have received into a referral, AND\n - create a task for the service provider admin team to select/shortlist appropriate services for the patient, AND\n - provide final guidance response details back to the referrer\n\nNote: This endpoint is only allowed to be used if the referrer has authorised the provider to convert the advice \nand guidance request into a referral.\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request. \nThis will include whether or not the referrer has authorised the provider to be able to convert an \nadvice and guidance request into a referral, and thus dictate whether this endpoint can be used.\n\nYou need to use [[HYPERLINK_A025]] to retrieve the conversation within an advice and guidance request.\n\nIf you want to include attachments with the admin task and/or the response to the referrer, \nyou need to use [[HYPERLINK_A020]] so they are ready to be associated when this endpoint is called.\n\n## Use case\nAs an authenticated user\n\nI need to convert an inbound advice and guidance request into a referral \nand task my admin team to shortlist appropriate services for the patient\n\nSo that I can progress the patient's care along the most appropriate referral pathway.\n\n## Important notes\n\nWhen this endpoint is successfully used, an entry will be added to the service providers \nAppointments For Booking worklist for the admin team to action the task. The provider \nadmin team will currently only be able to progress the referral via the e-RS Professional \nApplication user interface (e.g. shortlisting appropriate services for the patient).\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Related endpoints\n\nYou can use [[HYPERLINK_A005]] to retrieve the details of the referral.\n\nYou can use [[HYPERLINK_A024]] to retrieve the latest summary of the advice and guidance request.\n\nYou can use [[HYPERLINK_A025]] to retrieve the latest conversation within the advice and guidance request.\n\nYou can use [[HYPERLINK_A006]] to retrieve the clinical attachments for a referral/advice request.\n\nYou can use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for a referral.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Convert advice and guidance request to referral (A027, FHIR STU3)", - "operationId": "a027-convert-a&g-to-referral", - "tags": [ - "Review advice and guidance requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CreateFromCommunicationRequestActionLater-Request-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateFromCommunicationRequestActionLater-Request-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateFromCommunicationRequestActionLater-Request-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------------- |\n| `createFrom` | `1..1` | |\n| `guidance` | `1..1` | Mandatory guidance response. Maximum 8000 characters. |\n| `newReferralPriority` | `1..1` | | \n| `reviewComments` | `1..1` | |\n| `guidanceAttachmentFile` | `0..*` | Property defining files to be included with the supplied `guidance` text | \n| `reviewAttachmentFile` | `0..*` | Property defining files to be associated with the created `ReferralRequest` | \n", - "items": { - "anyOf": [ - { - "title": "createFrom", - "description": "Parameter to supply a createFrom", - "type": "object", - "required": [ - "name", - "valueReference" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "createFrom" - ], - "example": "createFrom" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "CommunicationRequest/000000070000/_history/4" - } - } - } - } - }, - { - "title": "guidance", - "description": "Parameter to supply the guidance", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "guidance" - ], - "example": "guidance" - }, - "valueString": { - "type": "string", - "example": "I have converted this to send the patient to one of our services" - } - } - }, - { - "title": "newReferralPriority", - "description": "Parameter to supply a newReferralPriority", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "newReferralPriority" - ], - "example": "newReferralPriority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "reviewComments", - "description": "Parameter to supply the reviewComments", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "reviewComments" - ], - "example": "reviewComments" - }, - "valueString": { - "type": "string", - "example": "Refer this patient to our 'xxx' service please as soon as possible" - } - } - }, - { - "title": "guidanceAttachmentFile", - "description": "Parameter to supply a guidanceAttachmentFile", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "guidanceAttachmentFile" - ], - "example": "guidanceAttachmentFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "GUIDANCE_RESPONSE" - ], - "example": "GUIDANCE_RESPONSE" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - }, - { - "title": "reviewAttachmentFile", - "description": "Parameter to supply a reviewAttachmentFile", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "reviewAttachmentFile" - ], - "example": "reviewAttachmentFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER" - ], - "example": "PROVIDER" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "no-attachments": { - "summary": "No attachments", - "value": { - "$ref": "../../examples/convertAdviceAndGuidanceToReferral/requests/NoAttachments.json" - } - }, - "with-attachments": { - "summary": "With attachments", - "value": { - "$ref": "../../examples/convertAdviceAndGuidanceToReferral/requests/WithAttachments.json" - } - } - } - } - } - }, - "responses": { - "201": { - "description": "A referral converted from A&G request.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "no-attachments": { - "summary": "No attachments", - "value": { - "$ref": "../../../examples/convertAdviceAndGuidanceToReferral/responses/NoAttachments.json" - } - }, - "with-attachments": { - "summary": "With attachments", - "value": { - "$ref": "../../../examples/convertAdviceAndGuidanceToReferral/responses/WithAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNSUPPORTED_PRIORITY | The Priority submitted is not supported by the responsible Service. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| CONFLICTING_VALUES | Two or more supplied values are contradictory. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.recordReviewOutcome": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint, as a service provider, to record a triage outcome for the following referrals awaiting review:\n - referrals sent into a triage service\n - referrals deferred into a directly bookable service because of appointment slot unavailability\n\nWhilst a document can be uploaded via [[HYPERLINK_A020]] without a `NHSD-eRS-Referral-ID`, only documents that have a `NHSD-eRS-Referral-ID` can be associated using this end point. \nAn attempt to associate a document without a `NHSD-eRS-Referral-ID` will return an error response of 422 - `INAPPROPRIATE_VALUE`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Application-restricted, unattended access \nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nTo access this endpoint in application-restricted, unattended mode, you will be required to submit your use case for review. The only use case currently permitted is for non-clinical provider actions.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Referrals For Review' worklist. \n[[HYPERLINK_A028]] can only be used for referrals sent into triage services, and not the referrals \nbooked into bookable services.\n\nYou need to use [[HYPERLINK_A008]] to retrieve the contents of the 'Appointment Slot Issues' worklist. \nThis provides a list of referrals that have been deferred into directly bookable services.\n\n - Referrals from this worklist may already have been reviewed or may not have any referral clinical information associated, \n in which case [[HYPERLINK_A028]] cannot be used.\n - [[HYPERLINK_A028]] can only be used for those referrals, on the 'Appointment Slot Issues' worklist, which are pending review.\n - As such, you need to use [[HYPERLINK_A029]] to determine if [[HYPERLINK_A028]] is a permissible action.\n\nYou need to use [[HYPERLINK_A005]] to retrieve the details for the referral.\n\nYou need to use [[HYPERLINK_A006]] to retrieve the clinical attachments for the referral.\n\nYou need to use [[HYPERLINK_A007]] to retrieve the clinical information summary PDF for the referral.\n\nIf you want to include attachments with the triage outcome, you need to use [[HYPERLINK_A020]] so \nthey are ready to be associated when this endpoint is called.\n\n## Use cases\nAs an authenticated user\n\nI need to return the referral back to the referrer with some advice\n\nSo that I can progress the patient's care appropriately with the referrer.\n\n\nAs an authenticated user\n\nI need to accept the referral and task my admin team to shortlist appropriate services for the patient\n\nSo that I can progress the patient's care along the most appropriate referral pathway.\n\n\n## Important notes\n\n - The only outcomes that are supported by this endpoint are 'Return to referrer with advice' and 'Accept and refer/book later'. 'Refer/book now' is not supported.\n - The triage comment text is mandatory. This comment provided will be sent to:\n - The initial referrer when the 'Return to referrer with advice' triage outcome is chosen.\n - An administrator at the receiving service provider when the 'Accept and refer/book later' outcome is chosen.\n - The priority of the referral can be changed as part of recording the triage outcome\n - When this endpoint is successfully used for recording an outcome of 'Accept and refer/book later', \n an entry will be added to the service providers Appointments For Booking worklist for the admin team to action the task. \n The provider admin team will only be able to progress the referral via the e-RS Professional Application user \n interface (e.g. shortlisting appropriate services for the patient).\n - In order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \n The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n - Further details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Record triage outcome (A028, FHIR STU3)", - "operationId": "a028-record-triage-outcome", - "tags": [ - "Review referral requests" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-RecordReviewOutcome-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RecordReviewOutcome-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-RecordReviewOutcome-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `reviewOutcome` | `1..1` | |\n| `reviewComments` | `1..1` | |\n| `reviewPriority` | `0..1` | | \n| `reviewAttachmentFile` | `0..*` | | \n", - "items": { - "anyOf": [ - { - "title": "reviewOutcome", - "description": "Parameter to supply a reviewOutcome", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "reviewOutcome" - ], - "example": "reviewOutcome" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "CANCEL_APPOINTMENT_ACTION_LATER", - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "RETURN_TO_REFERRER_WITH_ADVICE" - } - } - } - } - }, - { - "title": "reviewComments", - "description": "Parameter to supply the reviewComments", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "reviewComments" - ], - "example": "reviewComments" - }, - "valueString": { - "type": "string", - "example": "Condition not serious. No further action needed" - } - } - }, - { - "title": "reviewPriority", - "description": "Parameter to supply a reviewPriority", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "reviewPriority" - ], - "example": "reviewPriority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "reviewAttachmentFile", - "description": "Parameter to supply an attachment file", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "reviewAttachmentFile" - ], - "example": "reviewAttachmentFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER" - ], - "example": "PROVIDER" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "return-to-referrer-with-advice": { - "summary": "Return to referrer with advice", - "value": { - "$ref": "../../examples/recordTriageOutcome/requests/ReturnToReferrerWithAdvice.json" - } - }, - "accept-refer-book-later": { - "summary": "Accept refer book later", - "value": { - "$ref": "../../examples/recordTriageOutcome/requests/AcceptReferBookLater.json" - } - }, - "attachment-included": { - "summary": "Attachment included", - "value": { - "$ref": "../../examples/recordTriageOutcome/requests/AttachmentIncluded.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "return-to-referrer-with-advice": { - "summary": "Return to referrer with advice", - "value": { - "$ref": "../../../examples/recordTriageOutcome/responses/ReturnToReferrerWithAdvice.json" - } - }, - "accept-refer-book-later": { - "summary": "Accept refer book later", - "value": { - "$ref": "../../../examples/recordTriageOutcome/responses/AcceptReferBookLater.json" - } - }, - "attachment-included": { - "summary": "Attachment included", - "value": { - "$ref": "../../../examples/recordTriageOutcome/responses/AttachmentIncluded.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PRIORITY_NOT_CURRENT | 'Review Priority' value cannot be amended if Review Outcome value is RETURN_TO_REFERRER_WITH_ADVICE |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_STATE | Indicates that the referenced item is not in the correct state for the request to be processed. |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| DUPLICATE_FILENAME | A file being attached, matches another file being attached, or matches a file that is already linked. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/R4/PractitionerRole": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to retrieve a list of available e-RS roles (i.e. business functions) at each organisation where the user works.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nIn order to use this endpoint you must be an authenticated user\n\n## Use case\n\nAs an authenticated user\n\nI need to retrieve a list of authorised e-RS roles for organisations I work for\n\nSo I can choose the appropriate role and organisation to work under when performing tasks.\n\n## Related endpoints\n\nYou can then use the e-RS roles to perform specific tasks using other e-RS endpoints e.g. to satisfy Role and Organisation validation.\n\n### Role and Organisation Validation\n\nThe response from a successful call to [[HYPERLINK_A030]] represents a Practitioner Role Bundle. \nEach Practitioner Role represents an e-RS Role at a specific Organisation. \n\nFor most e-RS endpoints requests are made in the context of a specific authorised e-RS Role at a specific Organisation for the authenticated user. \nThis is accomplished by setting the values of the `NHSD-eRS-Business-Function` and `NHSD-End-User-Organisation-ODS` request headers. \n\nThe e-RS Role is supplied to the endpoint via the `NHSD-eRS-Business-Function` request header. \n\nThe Organisation is supplied to the endpoint via the `NHSD-End-User-Organisation-ODS` request header. \n\nThe `entry` field in the response from [[HYPERLINK_A030]] is an array of PractitionerRole resources. An example of a PractitionerRole resource is: \n```\n\"resource\": {\n \"id\": \"PractitionerRole-R69-000000000101\",\n \"meta\": {\n \"lastUpdated\": \"2021-05-24T16:09:32.252Z\"\n },\n \"resourceType\": \"PractitionerRole\",\n \"practitioner\": {\n \"identifier\": {\n \"system\": \"https://fhir.nhs.uk/Id/sds-user-id\",\n \"value\": \"000000000101\"\n }\n },\n \"organization\": {\n \"identifier\": {\n \"system\": \"https://fhir.nhs.uk/Id/ods-organization-code\",\n \"value\": \"R69\"\n }\n },\n \"code\": [\n {\n \"coding\": [\n {\n \"system\": \"https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1\",\n \"code\": \"SERVICE_DEFINER\"\n }\n ]\n },\n {\n \"coding\": [\n {\n \"system\": \"https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1\",\n \"code\": \"SERVICE_PROVIDER_CLINICIAN\"\n }\n ]\n },\n {\n \"coding\": [\n {\n \"system\": \"https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1\",\n \"code\": \"SERVICE_PROVIDER_ADMIN\"\n }\n ]\n }\n ]\n},\n```\nEach PractitionerRole resource has a `code` field which is an array of codings. \nThe authorised e-RS Roles for the authenticated user at a particular Organisation are represented by the `value` fields in the `https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1` code system. \nThe `NHSD-eRS-Business-Function` request header value should be the `code` field value from the relevant eRS-Business-Function-1 coding in the PractitionerRole resource e.g. `SERVICE_PROVIDER_CLINICIAN`.\n\nEach PractitionerRole resource also has an `organization` field which has an identifier in the `https://fhir.nhs.uk/Id/ods-organization-code` code system.\nThe `NHSD-End-User-Organisation-ODS` request header value should be the `value` field value from the organization identifier in the PractitionerRole resource e.g. \"R69\".\n", - "summary": "Retrieve user business functions (A030, FHIR R4)", - "operationId": "a030-retrieve-business-functions", - "tags": [ - "Retrieve user information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "The response body is a `Bundle` that contains `PractitionerRole` entries which define the [[HYPERLINK_ERS_BUS_FUNCTIONS]] that the user has available at each `Organisation` where they have a role.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "Bundle resource containing practitioner roles", - "description": "The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle \n", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "type", - "total", - "link" - ], - "properties": { - "id": { - "type": "string", - "example": "08acc887-6a7b-4b38-8f50-022e41319efe" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Bundle" - ], - "example": "Bundle" - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "total": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 1 - }, - "link": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/R4/PractitionerRole" - } - } - } - }, - "entry": { - "type": "array", - "items": { - "type": "object", - "required": [ - "fullUrl", - "search", - "resource" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/R4/PractitionerRole/PractitionerRole-R69-000000000101" - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - }, - "resource": { - "type": "object", - "description": "A UKCore-Practitioner Role. The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-PractitionerRole", - "required": [ - "id", - "meta", - "resourceType", - "practitioner", - "organization", - "code" - ], - "properties": { - "id": { - "type": "string", - "example": "PractitionerRole-R69-000000000101" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "PractitionerRole" - ], - "example": "PractitionerRole" - }, - "practitioner": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/sds-user-id" - ], - "example": "https://fhir.nhs.uk/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "organization": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - "code": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - } - } - } - } - } - } - } - } - } - }, - "examples": { - "example-response-body": { - "summary": "Example response body", - "value": { - "$ref": "../../../examples/retrieveBusinessFunctions/responses/PractitionerRoleBundle.json" - } - } - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-supported", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_ACCEPTABLE" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.changeShortlist": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to change the shortlist of bookable and/or triage services on an existing referral.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Important notes\n\nThe maximum amount of services allowed on a given shortlist is 20.\n\nThe act of changing a shortlist alone will not result in a referral being sent/booked to any of the shortlisted services (even if only one service is shortlisted). \nA shortlist of a single triage service should be avoided as this relies on the patient to progress the referral, potentially leading to a delay to care. Especially if the referral priority is 2WW or Urgent.\n\nUse [[HYPERLINK_A016]] if there is a need to support the sending/booking of the referral into a shortlisted service.\n\nA patient can request assistance at a service (e.g. a translator, transport or advocacy) when a shortlist is created within the e-RS web application, meaning that all services shortlisted would support the patient's additional requirements to attend.\n\nThe e-RS APIs do not currently support patients' additional requirements so you can neither specify services that support patients' additional requirements, arrange additional requirements for a patient, or view comments associated with the request for additional requirements.\n\nYou must consider if you are fully meeting the patient's additional requirement needs if there are additional requirements associated with the referral.\n\nIf you do not know whether the patient has an existing additional requirement need and the referral may have been shortlisted within the e-RS web application, be mindful that if you chose to amend the shortlist via changing the services, you could remove this patient need.\n\nIf you are changing services to send the patient to a triage service, the triaging service will not support additional requirements but will need to consider if the patient has any additional requirements as part of their decision for future care.\n\nYou can view additional requirements on a referral via the e-RS web application or by fetching [[HYPERLINK_A005]].\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Use case\nAs an authenticated user\n\nI need to change the shortlist of bookable services and/or triage services on an existing referral\n\nSo that I can adequately manage my patients referral pathway, allowing the patient to book into an appropriate service.\n\n## Related endpoints\nTo allow the patient to book their appointment in their own time, you can generate a letter for the patient by using [[HYPERLINK_A019]]. The letter summarises the current state of the referral and any steps the patient may need to follow (e.g. appointment booking instructions).\n\nYou can book an appointment for the patient into a shortlisted directly bookable service using [[HYPERLINK_A015]] and [[HYPERLINK_A016]].\n\nYou can send the referral into a shortlisted triage service using [[HYPERLINK_A016]].\n\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A007]], and [[HYPERLINK_A006]] endpoints where necessary.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Change shortlist (A031, FHIR STU3)", - "operationId": "a031-change-shortlist", - "tags": [ - "Manage referral" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ChangeShortlist-Parameters", - "type": "object", - "description": "Parameters provided when looking to change the services a referral has currently shortlisted", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlist-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlist-Parameters-1" - } - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `Shortlist` | `1..1` | Shortlist indicating the new services a referral should have shortlisted |\n| `IntentionToAddReferralLetter` | `1..1` | Flag indicating whether a referral letter is going to be added later or is already added | \n| `FirstReminderLetterFollowUpDays` | `1..1` | Time at which a reminder should be sent to remind the patient about the referral |\n", - "items": { - "anyOf": [ - { - "title": "Shortlist", - "description": "Parameter to supply a shortlist", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "shortlist" - ], - "example": "shortlist" - }, - "resource": { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - } - } - }, - { - "title": "IntentionToAddReferralLetter", - "description": "Parameter to supply the intention to add referral letter flag", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "intentionToAddReferralLetter" - ], - "example": "intentionToAddReferralLetter" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - }, - "code": { - "type": "string", - "enum": [ - "NEED_TO_ADD_LATER", - "NOT_INTENDING_TO_ADD" - ], - "example": "NEED_TO_ADD_LATER" - } - } - } - } - }, - { - "title": "FirstReminderLetterFollowUpDays", - "description": "Parameter to supply the first reminder follow up days", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "firstReminderLetterFollowUpDays" - ], - "example": "firstReminderLetterFollowUpDays" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 0 - } - } - } - ] - } - } - } - }, - "examples": { - "unbookedReferralRequest": { - "summary": "Unbooked ReferralRequest", - "description": "Changing the shortlist of an unbooked `ReferralRequest` (single service shortlist)", - "value": { - "$ref": "../../examples/changeShortlist/requests/UnbookedReferral.json" - } - }, - "unbookedReferralRequestMultipleServices": { - "summary": "Unbooked ReferralRequest with Multiple Services", - "description": "Changing the shortlist of an unbooked `ReferralRequest` (multiple services shortlist)", - "value": { - "$ref": "../../examples/changeShortlist/requests/UnbookedReferralMultipleServices.json" - } - }, - "unbookedReferralRequestMixedShortlist": { - "summary": "Unbooked ReferralRequest with Bookable and Triage Services", - "description": "Changing the shortlist of an unbooked `ReferralRequest` (multiple services shortlist)", - "value": { - "$ref": "../../examples/changeShortlist/requests/UnbookedReferralMixedShortlist.json" - } - }, - "nonMixedShortlistWithDocument": { - "summary": "ReferralRequest with non Mixed service and Document Reference", - "description": "Changing the shortlist of an `ReferralRequest` with document reference.", - "value": { - "$ref": "../../examples/changeShortlist/requests/NonMixedShortlistWithDocument.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Referral updated with new service list", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - }, - "examples": { - "unbookedReferralRequest": { - "summary": "Unbooked ReferralRequest", - "description": "Changing the shortlist of an unbooked `ReferralRequest` (single service shortlist)", - "value": { - "$ref": "../../../examples/changeShortlist/responses/UnbookedReferral.json" - } - }, - "unbookedReferralRequestMultipleServices": { - "summary": "Unbooked ReferralRequest with Multiple Services", - "description": "Changing the shortlist of an unbooked `ReferralRequest` (multiple services shortlist)", - "value": { - "$ref": "../../../examples/changeShortlist/responses/UnbookedReferralMultipleServices.json" - } - }, - "unbookedReferralRequestMixedShortlist": { - "summary": "Unbooked ReferralRequest with Mixed Services", - "description": "Changing the shortlist of an unbooked `ReferralRequest` (bookable and triage service shortlist)", - "value": { - "$ref": "../../../examples/changeShortlist/responses/UnbookedReferralMixedShortlist.json" - } - }, - "nonMixedShortlistWithDocument": { - "summary": "ReferralRequest with non Mixed service and Document Reference", - "description": "Changing the shortlist of an `ReferralRequest` with document reference.", - "value": { - "$ref": "../../../examples/changeShortlist/responses/NonMixedShortlistWithDocument.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostic property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.changeShortlistAndSendForTriage": { - "post": { - "deprecated": true, - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n**This endpoint has now been deprecated please use [[HYPERLINK_A031]] instead.**\n\nUse this endpoint to change the shortlist to a single triage service and refer the patient directly to that triage service.\n\nPlease note: this endpoint cannot be used to shortlist bookable services. In order to shortlist bookable services on an existing referral please use [[HYPERLINK_A031]].\n\nA patient can request assistance at a service (e.g. a translator, transport or advocacy) when a shortlist is created within the e-RS web application, meaning that all services shortlisted would support the patient's additional requirements to attend.\n\nThe e-RS APIs do not currently support patients' additional requirements so you can neither specify services that support patients' additional requirements, arrange additional requirements for a patient, or view comments associated with the request for additional requirements.\n\nYou must consider if you are fully meeting the patient's additional requirement needs if there are additional requirements associated with the referral.\n\nIf you do not know whether the patient has an existing additional requirement need and the referral may have been shortlisted within the e-RS web application, be mindful that if you chose to amend the shortlist via changing the services, you could remove this patient need.\n\nIf you are changing services to send the patient to a triage service, the triaging service will not support additional requirements but will need to consider if the patient has any additional requirements as part of their decision for future care.\n\nYou can view additional requirements on a referral via the e-RS web application or by fetching [[HYPERLINK_A005]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral request in order to use this endpoint.\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\n## Important Notes\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. The availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications.\n\n## Use case\nAs an authenticated user\n\nI need to change the shortlist and refer the patient to a triage service for assessment\n\nSo that I can put the patient on the appropriate clinical pathway for the chosen service provider.\n\n## Related endpoints\nFor the referral to be processed by the service provider, you must ensure appropriate referral letter information has been added to the referral. You can add/manage referrer letter information by using [[HYPERLINK_A012]].\n\nYou can check to see what referral letter information has already been added to a referral by using [[HYPERLINK_A005]], [[HYPERLINK_A006]], and [[HYPERLINK_A007]] endpoints where necessary.\n\nYou can calculate the date when the patient will need to be contacted (by the triage service) using reference data from [[HYPERLINK_A004]].\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Change shortlist and send for triage (A032, FHIR STU3) [deprecated]", - "operationId": "a032-change-shortlist-and-send-for-triage", - "tags": [ - "Manage referral" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ChangeShortlistAndSendForTriage-Request-Parameters", - "type": "object", - "description": "Parameters provided when looking to change the services a referral has currently shortlisted", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Request-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Request-Parameters-1" - } - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `Shortlist` | `1..1` | Shortlist indicating the new service a referral should have shortlisted |\n| `IntentionToAddReferralLetter` | `1..1` | Flag indicating whether a referral letter is going to be added later or is already added | \n| `FirstReminderLetterFollowUpDays` | `1..1` | Time at which a reminder should be sent to remind the patient about the referral |\n", - "items": { - "anyOf": [ - { - "title": "Shortlist", - "description": "Parameter to supply a shortlist. When sending for triage, \nthe shortlist must contain exactly one service, and this must support the 'triage request flow'.\n", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "shortlist" - ], - "example": "shortlist" - }, - "resource": { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - } - } - }, - { - "title": "IntentionToAddReferralLetter", - "description": "Parameter to supply the intention to add referral letter flag", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "intentionToAddReferralLetter" - ], - "example": "intentionToAddReferralLetter" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralLetterIntention-1" - }, - "code": { - "type": "string", - "enum": [ - "NEED_TO_ADD_LATER", - "NOT_INTENDING_TO_ADD" - ], - "example": "NEED_TO_ADD_LATER" - } - } - } - } - }, - { - "title": "FirstReminderLetterFollowUpDays", - "description": "Parameter to supply the first reminder follow up days. When sending for triage, \nthe only acceptable value is 0, which means no follow up letter will be sent, \nas the patient does not need to book an appointment.\n", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "firstReminderLetterFollowUpDays" - ], - "example": "firstReminderLetterFollowUpDays" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 0 - } - } - } - ] - } - } - } - }, - "examples": { - "parameters": { - "summary": "Unbooked ReferralRequest", - "description": "Changing the service list of an unbooked `ReferralRequest` and sending to Triage", - "value": { - "$ref": "../../examples/changeShortlistAndSendForTriage/requests/MinimalRequest.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "Referral updated with new service and sent for Triage", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-ChangeShortlistAndSendForTriage-Response-Parameters", - "type": "object", - "description": "Parameters provided when looking to change the services a referral has currently shortlisted", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Response-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ChangeShortlistAndSendForTriage-Response-Parameters-1" - } - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `updatedReferralRequest` | `1..1` | |\n| `createdAppointment` | `1..1` | | \n", - "items": { - "anyOf": [ - { - "title": "updatedReferralRequest", - "description": "Parameter containing the updated referral request", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "updatedReferralRequest" - ], - "example": "updatedReferralRequest" - }, - "resource": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - } - } - }, - { - "title": "createdAppointment", - "description": "Parameter containing the newly created appointment", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "createdAppointment" - ], - "example": "createdAppointment" - }, - "resource": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "unbookedReferralRequest": { - "summary": "TriagedReferralRequest", - "description": "Changing the service list of an unbooked `ReferralRequest` and send for Triage", - "value": { - "$ref": "../../../examples/changeShortlistAndSendForTriage/responses/MinimalRequest.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostic property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an active request. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/R4/HealthcareService/{id}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nA patient may have 0 to 20 services associated with a single referral. A service is a place where a referrer can send a patient or obtain clinical \nadvice concerning a specific patient. Services have attributes that can be used to understand a services functionality, terms of use, and contact \ninformation. \nYou can use this endpoint to obtain the current version and attributes of a single service.\n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified one service ID in order to use this endpoint.\n\n## Use case\nAs an authenticated user\n\nI would like to be able to see current service information\n\nSo that I can trust that the service information is correct for my patient's referral\n\n## Related endpoints\n - You can retrieve service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist containing at least a single service.\n - You can check if a cached service has changed via [[HYPERLINK_A037]].\n - You can retrieve the attributes of an entire shortlist of services (1-20) via [[HYPERLINK_A035]].\n\n## Known Issues\nThe HealthcareService.type attribute is being returned as a singular object by this endpoint. As per the [FHIR standard](https://hl7.org/fhir/R4/), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Service Id |\n| ------------------------------------------------------------------------ | ---------- |\n| `Service` and minimal attributes | `1` |\n| `Service` and its attributes | `2` |\n", - "summary": "Retrieve healthcare service (A033, FHIR R4)", - "operationId": "a033-retrieve-healthcare-service", - "tags": [ - "Retrieve healthcare service information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "name": "id", - "in": "path", - "description": "The ID of the service to be retrieved. It must be valid and relate to an existing Healthcare Service otherwise a HTTP 404 response will be returned.\n", - "required": true, - "schema": { - "type": "string", - "example": "1" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "Response contains the Healthcare Service requested.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Cache-Control": { - "description": "To specify the caching policies in client requests and server responses\n", - "required": false, - "schema": { - "type": "string", - "example": "no-cache" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-HealthcareService", - "description": "A e-referral service. The canonical URL: https://fhir.nhs.uk/StructureDefinition/eRS-HealthcareService", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "location", - "name" - ], - "properties": { - "id": { - "type": "string", - "example": "1" - }, - "meta": { - "type": "object", - "required": [ - "versionId" - ], - "properties": { - "versionId": { - "type": "string", - "example": "1" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "HealthcareService" - ], - "example": "HealthcareService" - }, - "extension": { - "type": "array", - "nullable": false, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| Extension-eRS-HoursOfOperation | 0..1 | Details the hours the current HealthcareService is operational |\n| Extension-eRS-HealthcareService-Contact | 0..* | Details any contact information for the HealthcareService |\n| Extension-eRS-ServiceInstructions | 0..1 | Outlines any specific instructions that should be followed around the HealthcareService |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-HoursOfOperation", - "description": "Extension to detail the hours of operation outlined for a HealthcareService.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" - ], - "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" - }, - "valueString": { - "type": "string", - "example": "9-5 Monday to Friday" - } - } - }, - { - "title": "Extension-eRS-HealthcareService-Contact", - "description": "Extension detailing the contact details for a HealthcareService", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" - ], - "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| purpose | 1..1 | Details who should be using the current contact method |\n| telecom | 1..* | Outlines the contact details to be used |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "purpose", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "purpose" - ], - "example": "purpose" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "enum": [ - "http://terminology.hl7.org/CodeSystem/contactentity-type", - "https://fhir.nhs.uk/CodeSystem/eRS-Purpose" - ], - "example": "http://terminology.hl7.org/CodeSystem/contactentity-type" - }, - "code": { - "type": "string", - "enum": [ - "BILL", - "ADMIN", - "HR", - "PAYOR", - "PATINF", - "PRESS", - "HEALTHCARE_PROFESSIONALS" - ], - "example": "PATINF" - }, - "display": { - "type": "string", - "enum": [ - "Billing", - "Administrative", - "Human Resource", - "Payor", - "Patient", - "Press", - "Healthcare Professionals" - ], - "example": "Patient" - } - } - } - } - } - } - } - }, - { - "type": "object", - "title": "telecom", - "required": [ - "url", - "valueContactPoint" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "telecom" - ], - "example": "telecom" - }, - "valueContactPoint": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "phone", - "email" - ], - "example": "phone" - }, - "value": { - "type": "string", - "example": "01235 209823" - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-ServiceInstructions", - "description": "Extension to detail any service instructions for a HealthcareService.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" - ], - "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" - }, - "valueString": { - "type": "string" - } - } - } - ] - } - }, - "location": { - "type": "array", - "items": { - "type": "object", - "properties": { - "identifier": { - "description": "Reference detailing the location a service is based within.", - "type": "object", - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-site-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-site-code" - }, - "value": { - "type": "string", - "example": "R6901" - } - } - } - } - } - }, - "name": { - "type": "string", - "example": "Direct SVC 1", - "description": "Name of the current HealthcareService within eRS" - }, - "type": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" - }, - "code": { - "type": "string", - "enum": [ - "DAY_CASE", - "FIRST_OUTPATIENT", - "ASSESSMENT_SERVICE", - "GPSI", - "AHP_CLINIC", - "DIAGNOSTIC", - "NURSE_CLINIC", - "OPHTHALMOLOGIST", - "TELEPHONE_ASSESSMENT" - ], - "example": "DAY_CASE" - }, - "display": { - "type": "string", - "enum": [ - "Day Case", - "First Outpatient", - "Assessment Service", - "GPSI", - "AHP Clinic", - "Diagnostic", - "Nurse Clinic", - "Ophthalmologist", - "Telephone Assessment" - ], - "example": "Day Case" - } - } - } - } - } - } - }, - "characteristic": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-RequestFlowType", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" - }, - "code": { - "type": "string", - "enum": [ - "BOOKABLE", - "REVIEW", - "ADVICE_AND_GUIDANCE" - ], - "example": "BOOKABLE" - }, - "display": { - "enum": [ - "A service which supports a patient appointment", - "A service that reviews referrals, without the support or need for any appointment with the patient to be made", - "A service which can discuss the patient and receive guidance rather than a patient attending an appointment" - ], - "example": "A service which supports a patient appointment" - } - } - }, - { - "type": "object", - "title": "eRS-BookableType", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" - }, - "code": { - "type": "string", - "enum": [ - "DIRECTLY_BOOKABLE", - "INDIRECTLY_BOOKABLE" - ], - "example": "DIRECTLY_BOOKABLE" - }, - "display": { - "enum": [ - "Directly Bookable", - "Indirectly Bookable" - ], - "example": "Directly Bookable" - } - } - } - ] - } - } - } - } - } - } - }, - "examples": { - "single-service-minimal": { - "summary": "Service and minimal attributes.", - "value": { - "$ref": "../../../examples/getService/responses/sampleServiceWithMinimumAttributes.json" - } - }, - "single-service": { - "summary": "Service and its attributes.", - "value": { - "$ref": "../../../examples/getService/responses/sampleServiceWithFullAttributes.json" - } - } - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-found", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_FOUND" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-supported", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_ACCEPTABLE" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - }, - "head": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nA Patient may have 0 to 20 services associated with a single referral. \nA service is a place where a referrer can send a patient or obtain clinical advice concerning a specific patient.\n\nYou can use this endpoint to obtain the current service's \"version\" held in e-RS, in order to compare to a locally cached version. \n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified one service ID in order to use this endpoint.\n\n## Use case\nAs an authenticated user\n\nI would like to be able to see the current information about a service on my patients current shortlist\n\nSo that I can review and trust the information is still valid within the context of my patients needs\n\n## Related endpoints\n - You can obtain Service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist containing at least one service.\n - You can retrieve a set of services and their attributes via [[HYPERLINK_A035]].\n - You can fetch the attributes of a single service via [[HYPERLINK_A033]].\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Service Id |\n| ------------------------------------------------------------------------ | ---------- |\n| Get `Service` Version | `1` |\n", - "summary": "Retrieve healthcare service version (A037, FHIR R4)", - "operationId": "a037-retrieve-healthcare-service-version", - "tags": [ - "Retrieve healthcare service information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "name": "id", - "in": "path", - "description": "The ID of the service to be retrieved. It must be valid and relate to an existing Healthcare Service otherwise a HTTP 404 response will be returned.\n", - "required": true, - "schema": { - "type": "string", - "example": "1" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "responses": { - "200": { - "description": "Response doesn't contain the payload. But the current version of the Healthcare Service is in the ETag Response Header.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "cache-control": { - "description": "To specify the caching policies in client requests and server responses\n", - "required": false, - "schema": { - "type": "string", - "example": "no-cache" - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_RELATIONSHIP | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The caller has no legitimate relationship with the resource. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-found", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_FOUND" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Appointment/{id}": { - "put": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to cancel an appointment that is booked into a directly-bookable service. Appointments made to directly-bookable services always have a date and time. You can only ever update the current appointment, i.e. an appointment that is related to a service on the current shortlist *and* the most recent appointment made.\n\nCurrently, this endpoint only allows cancellation of an appointment as an update. Future developments may permit further updates.\n\nTo cancel the referral, use [[HYPERLINK_A036]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n\nYou must use [[HYPERLINK_A004]] to retrieve reference data from the set `APPOINTMENT-CANCELLATION-REASON`.\n\nTo find out which reference data from this set can be used to cancel an appointment, filter as follows:\n\n - *usage* must be `CANCEL`,\n - *businessFunction* must be `REFERRING_CLINICIAN` or `REFERRING_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action),\n - *effectiveFrom* must be in the past, and\n - *effectiveTo* must not be in the past\n\nBoth the appointment reference, and version, are needed to update an appointment:\n\nYou must use [[HYPERLINK_A005]] to obtain the current appointment reference (via *Extension-eRS-Appointment-Reference-1*).\n\nYou must use [[HYPERLINK_A038]] to obtain the current appointment and get the current appointment's version. \n\n## Use case\nAs an authenticated user\n\nI need to update the current appointment\n\nSo that I can manage the patients care appropriately. \n\n## Related endpoints\nYou can retrieve the reference data needed to cancel an appointment by using [[HYPERLINK_A004]]. This contains \"reasons\" for cancellation.\n\nYou can check if you currently can cancel the appointment by checking [[HYPERLINK_A029]].\n\nYou must use [[HYPERLINK_A005]] to obtain the current appointment reference (via *Extension-eRS-Appointment-Reference-1*) .\n\nYou must use [[HYPERLINK_A038]] to obtain the current appointment and get the current appointment's version. \n\nYou can use [[HYPERLINK_A031]] after updating an appointment, to create a new shortlist of services. After changing a shortlist, you may be able to [[HYPERLINK_A016]]. \n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n", - "summary": "Update appointment (A034, FHIR STU3)", - "operationId": "a034-update-appointment", - "tags": [ - "Change appointment" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "id", - "in": "path", - "description": "The ID of the appointment to be supplied. It must be valid and relate to an existing Appointment Id otherwise a HTTP 404 response will be returned.\n", - "required": true, - "schema": { - "type": "string", - "example": "70000" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - "examples": { - "minimal-cancellation-reason-only": { - "summary": "Minimal Cancellation - Only Reason Provided (when a cancellation comment is not mandatory)", - "value": { - "$ref": "../../examples/updateAppointment/requests/MinimalCancellationReasonOnlyCommentNotMandatory.json" - } - }, - "cancellation-reason-and-comment": { - "summary": "Reason and Comment Provided", - "value": { - "$ref": "../../examples/updateAppointment/requests/CancellationReasonAndMandatoryComment.json" - } - }, - "cancellation-reason-only-comment-mandatory": { - "summary": "Only Reason Provided (when a cancellation comment is mandatory)", - "value": { - "$ref": "../../examples/updateAppointment/requests/CancellationReasonOnlyCommentMandatory.json" - } - }, - "unauthorised-cancellation-reason": { - "summary": "Unauthorised Cancellation Reason", - "value": { - "$ref": "../../examples/updateAppointment/requests/CancellationInvalidReason.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "An appointment within e-RS.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - "examples": { - "minimal-cancellation-reason-only": { - "summary": "Minimal Cancellation - Only Reason Provided (when a cancellation comment is not mandatory)", - "value": { - "$ref": "../../../examples/updateAppointment/responses/MinimalCancellationReasonOnlyCommentNotMandatory.json" - } - }, - "cancellation-reason-and-comment": { - "summary": "Reason and Comment Provided", - "value": { - "$ref": "../../../examples/updateAppointment/responses/CancellationReasonAndMandatoryComment.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_STATE | A note describing that the Request is not in the correct state should be returned to the caller. |\n| INVALID_VALUE | Reason provided is not a valid Cancellation Reason. |\n| INAPPROPRIATE_VALUE | Reason provided is not a valid in this case. |\n| MISSING_VALUE | Part of early validation that checks that the input conforms with the specifications of the FHIR profiles. A field defined as Mandatory on the FHIR profile is not provided. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| NO_RELATIONSHIP | No legitimate relationship with referral (UBRN). |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| UNABLE_TO_CANCEL_APPOINTMENT | Unable to cancel the appointment. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "examples": { - "cancellation-reason-only-comment-mandatory": { - "summary": "Only Reason Provided (when a cancellation comment is mandatory)", - "value": { - "$ref": "../../../examples/updateAppointment/responses/CancellationReasonOnlyCommentMandatory.json" - } - }, - "unauthorised-cancellation-reason": { - "summary": "Unauthorised Cancellation Reason", - "value": { - "$ref": "../../../examples/updateAppointment/responses/CancellationInvalidReason.json" - } - } - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "502": { - "description": "Where status code 502 (Bad Gateway) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_RESPONDED_WITH_ERROR | Error received from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_RESPONDED_WITH_ERROR", - "display": "Error received from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: ERROR" - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - }, - "504": { - "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "timeout", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_NOT_RESPONDING", - "display": "No response from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" - } - ] - } - } - } - } - } - }, - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to retrieve the current version of an appointment. An appointment is made to a service so a patient can be seen or for the referral to be reviewed, prior to care.\n\nA referral may, or may not, have an appointment and an appointment will always relate to a specific referral.\n\nIt is possible to have more than one appointment during the life of the referral, but never concurrent appointments. This endpoint only returns the current appointment and does not support historic views.\n\nThe outcome of a referral review can be recorded on an appointment. Cancellation or maintenance of an appointment (such as the intent to cancel the current appointment and book another one later) are recorded against the current appointment.\n\ne-RS currently supports a number of appointment scenarios:\n\n - Where a booking has been made to a directly-bookable service (DBS)\n - Where a deferred booking is made when a slot could not be found at a directly-bookable service. In this case, the service \"books\" the appointment\n - Where a booking has been made to a indirectly-bookable service (IBS)\n - Where a review is required by a triage service\n - Where a review has been conducted by a triage service\n - Where a service has rejected, or accepted an appointment\n - Where an appointment has been cancelled, and no further action is possible\n - Where an appointment is currently cancelled, but a future appointment may be made by a service later\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of a referral in order to retrieve details of an appointment that it relates to.\n\nNote: e-RS only supports the retrieval of the most recent version of Appointment. You cannot retrieve earlier versions.\n\n## Use case\n\nAs an authenticated user\n\nI want to read details of an appointment\n\nSo that I can decide what further action may be needed.\n\n## Related endpoints\nNote that in some cases below, an appointment forms part of the referral returned.\n\nYou can always retrieve the current version of an existing appointment via [[HYPERLINK_A005]].\n\nWhen successfully accepting an appointment, the accepted appointment is returned via [[HYPERLINK_A013]].\n\nWhen successfully rejecting an appointment, the rejected appointment is returned via [[HYPERLINK_A014]].\n\nWhen booking an appointment to a directly bookable service, deferring the booking responsibility to a directly bookable service, or referring a patient into a triage service, an \"appointment\" is returned via [[HYPERLINK_A016]].\n\nWhen successfully cancelling an appointment, to action it later, the cancelled appointment is returned via [[HYPERLINK_A022]].\n\nWhen converting an advice and guidance to a referral, if the referral has an appointment, it will be returned via [[HYPERLINK_A027]].\n\nHaving successfully reviewed a referral, details of that review are shown on the appointment returned via [[HYPERLINK_A028]].\n\nYou will need the appointment version when using [[HYPERLINK_A034]], which can be obtained from [[HYPERLINK_A038]].\n\nIf an appointment is cancelled as part of [[HYPERLINK_A036]], an appointment will be returned as part of a successful response.\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| --------------------------------------------------------------------------------------------------------- | ----------------------- |\n| `Appointment` booked to directly-bookable service | `appointmentId`=`70000` |\n| `Appointment` booked to indirectly-bookable service | `appointmentId`=`70001` |\n| `Appointment` deferred to service provider for booking | `appointmentId`=`70002` |\n| `Appointment` sent for triage | `appointmentId`=`70003` |\n| `Appointment` triage response (Record Triage Outcome) | `appointmentId`=`70004` |\n| `Appointment` Cancel Appointment, Action Later | `appointmentId`=`70005` |\n| `Appointment` cancelled | `appointmentId`=`70006` |\n| `Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service | `appointmentId`=`70007` |\n", - "summary": "Retrieve appointment (A038, FHIR STU3)", - "operationId": "a038-retrieve-appointment", - "tags": [ - "Change appointment" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "id", - "in": "path", - "description": "The ID of the appointment to be supplied. It must be valid and relate to an existing Appointment Id otherwise a HTTP 404 response will be returned.\n", - "required": true, - "schema": { - "type": "string", - "example": "70000" - } - } - ], - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - "examples": { - "booked-dbs": { - "summary": "`Appointment` booked to directly-bookable service", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/BookedDBS.json" - } - }, - "booked-ibs": { - "summary": "`Appointment` booked to indirectly-bookable service", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/BookedIBS.json" - } - }, - "deferred-to-provider": { - "summary": "`Appointment` deferred to service provider for booking", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/AppointmentDeferral.json" - } - }, - "deferred-to-triage": { - "summary": "`Appointment` sent for triage", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/TriageDeferral.json" - } - }, - "triage-response": { - "summary": "`Appointment` triage response (Record Triage Outcome)", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/TriageResponse.json" - } - }, - "cancel-appointment-action-later": { - "summary": "`Appointment` Cancel Appointment, Action Later", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/CAAL.json" - } - }, - "cancelled": { - "summary": "`Appointment` cancelled", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/Cancelled.json" - } - }, - "converted-and-booked": { - "summary": "`Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/AandGConvertedToDBS.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/Appointment/{id}/_history/{version}": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to retrieve a specific version of an `Appointment`.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nThe pre-requisites for this endpoint are the same as for endpoint [[HYPERLINK_A038]].\n\nNote: e-RS only supports the retrieval of the most recent version of an `Appointment`. You cannot retrieve earlier versions.\n\n## Use case\n\nSee [[HYPERLINK_A038]].\n\n## Related endpoints\n\nSee [[HYPERLINK_A038]].\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Request |\n| --------------------------------------------------------------------------------------------------------- | -------------------------------------- |\n| `Appointment` booked to directly-bookable service | `appointmentId`=`70000`, `version`=`5` |\n| `Appointment` booked to indirectly-bookable service | `appointmentId`=`70001`, `version`=`5` |\n| `Appointment` deferred to service provider for booking | `appointmentId`=`70002`, `version`=`5` |\n| `Appointment` sent for triage | `appointmentId`=`70003`, `version`=`5` |\n| `Appointment` triage response (Record Triage Outcome) | `appointmentId`=`70004`, `version`=`5` |\n| `Appointment` Cancel Appointment, Action Later | `appointmentId`=`70005`, `version`=`5` |\n| `Appointment` cancelled | `appointmentId`=`70006`, `version`=`5` |\n| `Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service | `appointmentId`=`70007`, `version`=`5` |\n", - "summary": "Retrieve appointment (versioned) (A038, FHIR STU3)", - "operationId": "a038-retrieve-appointment-versioned", - "tags": [ - "Change appointment" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "id", - "in": "path", - "description": "The ID of the appointment to be supplied. It must be valid and relate to an existing Appointment Id otherwise a HTTP 404 response will be returned.\n", - "required": true, - "schema": { - "type": "string", - "example": "70000" - } - }, - { - "name": "version", - "in": "path", - "description": "The version of the resource to be retrieved. It must be the latest version of the resource otherwise\n`HISTORY_NOT_SUPPORTED` error will be returned (HTTP 404 Not Found).\n", - "required": true, - "schema": { - "type": "string", - "example": "5" - } - } - ], - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "ETag": { - "description": "Record version identifier enclosed in quotes and preceded by 'W/'. For example, `W/\"2\"`.\n\nThis Weak ETag corresponds to `meta.versionId` attribute in the resource body.\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"2\"" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - "examples": { - "booked-dbs": { - "summary": "`Appointment` booked to directly-bookable service", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/BookedDBS.json" - } - }, - "booked-ibs": { - "summary": "`Appointment` booked to indirectly-bookable service", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/BookedIBS.json" - } - }, - "deferred-to-provider": { - "summary": "`Appointment` deferred to service provider for booking", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/AppointmentDeferral.json" - } - }, - "deferred-to-triage": { - "summary": "`Appointment` sent for triage", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/TriageDeferral.json" - } - }, - "triage-response": { - "summary": "`Appointment` triage response (Record Triage Outcome)", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/TriageResponse.json" - } - }, - "cancel-appointment-action-later": { - "summary": "`Appointment` Cancel Appointment, Action Later", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/CAAL.json" - } - }, - "cancelled": { - "summary": "`Appointment` cancelled", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/Cancelled.json" - } - }, - "converted-and-booked": { - "summary": "`Appointment` converted from an Advice and Guidance Request and booked to a directly-bookable service", - "value": { - "$ref": "../../../examples/retrieveAppointment/responses/AandGConvertedToDBS.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/R4/HealthcareService": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nA Patient may have 0 to 20 Services associated with a single referral. \nA service is a place where a referrer can send a patient or obtain clinical advice concerning a specific patient. \nYou can use this endpoint to obtain a set of services (up to 20) and their associated attributes, in a single call. \n\n## Supported security patterns\n- Application-restricted, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n### Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Referring Organisation.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified at least one service ID in order to use this endpoint.\n\n## Use case\nAs an authenticated user\n\nI would like to obtain information about all services on my patient's current shortlist\n\nSo that I can review the entire shortlist of services and each service's current attributes\n\n## Related endpoints\n - You can retrieve service IDs on a referral via [[HYPERLINK_A005]] as long as the referral has a shortlist of at least one service.\n - You can check if a cached service has changed via [[HYPERLINK_A037]].\n - You can fetch the attributes of a single service via [[HYPERLINK_A033]].\n\n## Known Issues\nThe HealthcareService.type attribute is being returned as a singular object by this endpoint. As per the [FHIR standard](https://hl7.org/fhir/R4/), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | Service Id |\n| ------------------------------------------------------------------------------------------------------------- | ---------- |\n| Search for multiple service with minimal attributes | `1,2` |\n| Search for multiple service max and min attributes | `3`,`4` |\n| Search for multiple service, where the service IDs are formatted correctly, but none of the service IDs match | `5`,`6` |\n", - "summary": "Search for healthcare services (A035, FHIR R4)", - "operationId": "a035-search-for-healthcare-services", - "tags": [ - "Retrieve healthcare service information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "query", - "name": "_id", - "description": "One or many service ID(s) to include as part of the search. Must be supplied, otherwise a 400 response will be returned.\n", - "required": true, - "schema": { - "type": "string", - "example": "1,2" - } - } - ], - "responses": { - "200": { - "description": "Bundle resource containing the `eRS-HealthcareService` resources associated to the supplied search criteria. \nThe canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle \n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "Bundle resource containg healthcare services", - "type": "object", - "required": [ - "id", - "meta", - "type", - "timestamp", - "total", - "link" - ], - "properties": { - "id": { - "type": "string", - "example": "123e4567-e89b-12d3-a456-426614174000" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "timestamp": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.00Z" - }, - "total": { - "description": "The total number of HeatlhcareServices that matched the supplied search critera", - "type": "integer", - "example": 1 - }, - "link": { - "type": "array", - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/R4/HealthcareService?_id=1,2" - } - } - } - }, - "entry": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `HealthcareService` | `0..*` | | \n", - "items": { - "title": "HealthcareService", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/R4/HealthcareService/1" - }, - "resource": { - "title": "eRS-HealthcareService", - "description": "A e-referral service. The canonical URL: https://fhir.nhs.uk/StructureDefinition/eRS-HealthcareService", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "location", - "name" - ], - "properties": { - "id": { - "type": "string", - "example": "1" - }, - "meta": { - "type": "object", - "required": [ - "versionId" - ], - "properties": { - "versionId": { - "type": "string", - "example": "1" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "HealthcareService" - ], - "example": "HealthcareService" - }, - "extension": { - "type": "array", - "nullable": false, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| Extension-eRS-HoursOfOperation | 0..1 | Details the hours the current HealthcareService is operational |\n| Extension-eRS-HealthcareService-Contact | 0..* | Details any contact information for the HealthcareService |\n| Extension-eRS-ServiceInstructions | 0..1 | Outlines any specific instructions that should be followed around the HealthcareService |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-HoursOfOperation", - "description": "Extension to detail the hours of operation outlined for a HealthcareService.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" - ], - "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HoursOfOperation" - }, - "valueString": { - "type": "string", - "example": "9-5 Monday to Friday" - } - } - }, - { - "title": "Extension-eRS-HealthcareService-Contact", - "description": "Extension detailing the contact details for a HealthcareService", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" - ], - "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-HealthcareService-Contact" - }, - "extension": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | --------------------------------------------------------------------------------------- |\n| purpose | 1..1 | Details who should be using the current contact method |\n| telecom | 1..* | Outlines the contact details to be used |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "purpose", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "purpose" - ], - "example": "purpose" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "enum": [ - "http://terminology.hl7.org/CodeSystem/contactentity-type", - "https://fhir.nhs.uk/CodeSystem/eRS-Purpose" - ], - "example": "http://terminology.hl7.org/CodeSystem/contactentity-type" - }, - "code": { - "type": "string", - "enum": [ - "BILL", - "ADMIN", - "HR", - "PAYOR", - "PATINF", - "PRESS", - "HEALTHCARE_PROFESSIONALS" - ], - "example": "PATINF" - }, - "display": { - "type": "string", - "enum": [ - "Billing", - "Administrative", - "Human Resource", - "Payor", - "Patient", - "Press", - "Healthcare Professionals" - ], - "example": "Patient" - } - } - } - } - } - } - } - }, - { - "type": "object", - "title": "telecom", - "required": [ - "url", - "valueContactPoint" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "telecom" - ], - "example": "telecom" - }, - "valueContactPoint": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "phone", - "email" - ], - "example": "phone" - }, - "value": { - "type": "string", - "example": "01235 209823" - } - } - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-ServiceInstructions", - "description": "Extension to detail any service instructions for a HealthcareService.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" - ], - "example": "https://fhir.nhs.uk/StructureDefinition/Extension-eRS-ServiceInstructions" - }, - "valueString": { - "type": "string" - } - } - } - ] - } - }, - "location": { - "type": "array", - "items": { - "type": "object", - "properties": { - "identifier": { - "description": "Reference detailing the location a service is based within.", - "type": "object", - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-site-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-site-code" - }, - "value": { - "type": "string", - "example": "R6901" - } - } - } - } - } - }, - "name": { - "type": "string", - "example": "Direct SVC 1", - "description": "Name of the current HealthcareService within eRS" - }, - "type": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-AppointmentType" - }, - "code": { - "type": "string", - "enum": [ - "DAY_CASE", - "FIRST_OUTPATIENT", - "ASSESSMENT_SERVICE", - "GPSI", - "AHP_CLINIC", - "DIAGNOSTIC", - "NURSE_CLINIC", - "OPHTHALMOLOGIST", - "TELEPHONE_ASSESSMENT" - ], - "example": "DAY_CASE" - }, - "display": { - "type": "string", - "enum": [ - "Day Case", - "First Outpatient", - "Assessment Service", - "GPSI", - "AHP Clinic", - "Diagnostic", - "Nurse Clinic", - "Ophthalmologist", - "Telephone Assessment" - ], - "example": "Day Case" - } - } - } - } - } - } - }, - "characteristic": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-RequestFlowType", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-RequestFlowType" - }, - "code": { - "type": "string", - "enum": [ - "BOOKABLE", - "REVIEW", - "ADVICE_AND_GUIDANCE" - ], - "example": "BOOKABLE" - }, - "display": { - "enum": [ - "A service which supports a patient appointment", - "A service that reviews referrals, without the support or need for any appointment with the patient to be made", - "A service which can discuss the patient and receive guidance rather than a patient attending an appointment" - ], - "example": "A service which supports a patient appointment" - } - } - }, - { - "type": "object", - "title": "eRS-BookableType", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" - ], - "example": "https://fhir.nhs.uk/CodeSystem/eRS-BookableType" - }, - "code": { - "type": "string", - "enum": [ - "DIRECTLY_BOOKABLE", - "INDIRECTLY_BOOKABLE" - ], - "example": "DIRECTLY_BOOKABLE" - }, - "display": { - "enum": [ - "Directly Bookable", - "Indirectly Bookable" - ], - "example": "Directly Bookable" - } - } - } - ] - } - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - } - } - } - } - } - }, - "examples": { - "multiple-services-minimal": { - "summary": "Search for multiple service with minimal attributes.", - "value": { - "$ref": "../../../examples/searchForServices/responses/searchServiceWithMinmumalAttributes.json" - } - }, - "multiple-services-max-min": { - "summary": "Search for multiple service max and min attributes.", - "value": { - "$ref": "../../../examples/searchForServices/responses/searchServiceWithMaxAndMinAttributes.json" - } - }, - "multiple-services-empty": { - "summary": "Search for multiple service, where the service IDs are formatted correctly, but none of the service IDs match", - "value": { - "$ref": "../../../examples/searchForServices/responses/searchServiceWithEmptyResponse.json" - } - } - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------|\n| REC_BAD_REQUEST | invalid | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | Incorrect or missing expected value. For example; Service Id is invalid or missing, or an an attempt to request more than 20 Service Ids |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "invalid", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_BAD_REQUEST" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_RELATIONSHIP | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The caller has no legitimate relationship with the resource. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Where status code 404 (Not Found) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------- |\n| REC_NOT_FOUND | not-found | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The supplied URL or Resource does not exist on the server. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-found", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_FOUND" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-supported", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_ACCEPTABLE" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/ReferralRequest/{ubrn}/$ers.cancelReferral": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\nUse this endpoint to cancel a referral and the current appointment, if there is one. Cancelling a referral is a one-way process and results in an end-state. No further progression of care can occur once this action has been performed.\n\nA reason for cancelling an appointment must be provided. A comment on the cancellation is conditionally mandatory depending on the reason selected. See pre-requisites and related referrals for more information.\n\nYou can check if you can cancel a referral by calling [[HYPERLINK_A029]].\n\ne-RS does not allow a referral to be cancelled, without also cancelling the current appointment. Therefore, if there is a current appointment associated with the referral, this *must* be cancelled in advance, or at the same time.\n\nIn order to cancel (only) an appointment you must use [[HYPERLINK_A034]].\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n- Application-restricted, unattended access\n\n## Pre-requisites\n### Application-restricted, unattended access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\nTo access this endpoint in application-restricted, unattended mode, you will be required to submit your use case for review. The only use case currently permitted is for non-clinical provider actions.\n\n### Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n- `SERVICE_PROVIDER_CLINICIAN`\n- `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou must use [[HYPERLINK_A004]] to retrieve a list of reference data, which detail the reason the cancellation is being performed. You can only use reference data from the set `REFERRAL-CANCELLATION-REASON`.\n\n\nTo find out which reference data from this set can be used, the following filters can be used depending on the cancellation scenario:\n\n***1. I want to cancel the referral and the current appointment as a Referrer***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `REFERRING_CLINICIAN` or `REFERRING_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `canCancelAppointment` must be true, and\n\n * `effectiveFrom` must be in the past, and \n\n * if provided, `effectiveTo` must **not** be in the past\n\n\n***2. I want to cancel a referral, for which there is no current appointment as a Referrer***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `REFERRING_CLINICIAN` or `REFERRING_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `canCancelAppointment` could be true or false, and\n\n * `effectiveFrom` must be in the past, and\n\n * if provided, `effectiveTo` must **not** be in the past\n\n***3. I want to cancel the referral and the current appointment as a Service Provider***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `SERVICE_PROVIDER_CLINICIAN` or `SERVICE_PROVIDER_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `appointmentRequestCancellationReasonType` must be `PROVIDER` and `PATIENT`, and\n\n * `canCancelAppointment` must be true, and\n\n * `effectiveFrom` must be in the past, and \n\n * `effectiveTo` must **not** be in the past\n\n***4. I want to cancel a referral, for which there is no current appointment as a Service Provider***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `SERVICE_PROVIDER_CLINICIAN` or `SERVICE_PROVIDER_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `appointmentRequestCancellationReasonType` must be `PROVIDER` and `PATIENT`, and\n\n * `canCancelAppointment` could be true or false, and\n\n * `effectiveFrom` must be in the past, and \n\n * `effectiveTo` must **not** be in the past\n\n***5. I want to cancel the triage referral as a Service Provider***\n\n* Obtain reference data from `REFERRAL-CANCELLATION-REASON` and filter:\n\n * `referrerUsage` must be `CANCEL_REFERRAL`, and\n\n * `businessFunction` must be `SERVICE_PROVIDER_CLINICIAN` or `SERVICE_PROVIDER_CLINICIAN_ADMIN` (depending which authenticated user will be performing the action), and\n\n * `appointmentRequestCancellationReasonType` must be `PROVIDER_TRIAGE`, and\n\n * `effectiveFrom` must be in the past, and \n\n * `effectiveTo` must **not** be in the past\n\nYou need to use [[HYPERLINK_A005]] to retrieve details of the referral in order to make this clinical decision.\n\n## Important note when retrieving attachments\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code.\n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A005]] and [[HYPERLINK_A042]] specifications. \n\n## Important notes when providing an appointment request cancellation reason\n\nWhen cancelling a referral as a Service Provider Clinician:\n\n * If the referral is in the **\"Triaged - Provider to action\"** state, the cancellation reason must be an **Appointment Request End Triage Reason** type.\n\n * If the referral is **not** in that state, the cancellation reason must be a **Provider Appointment Request Cancellation Reason** or **Patient Appointment Request Cancellation Reason** type.\n\n## Use case\nAs an authenticated user\n\nI need to cancel a referral, and any active appointments\n\nSo that the referral is no longer processed\n\n## Related endpoints\nYou can retrieve the reference data needed to cancel a referral by using [[HYPERLINK_A004]]. This contains \"reasons\" for cancellation.\n\nYou can check if you can cancel the referral by checking [[HYPERLINK_A029]].\n\nYou can use [[HYPERLINK_A005]] to obtain a current appointment reference, if there is one. This endpoint will also provide you with the current UBRN version.\n\nYou can use [[HYPERLINK_A038]] to view the current appointment (where applicable).\n\n## Known Issues\n\n1. The Participant.type attribute is being mapped as a single type for this endpoint. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be an array. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n2. The participant of an Appointment references a value set. As per the Appointment [FHIR profile](https://hl7.org/fhir/STU3/appointment-definitions.html#Appointment.participant.type), this attribute should be a coding system. See our [problems and fixes](https://digital.nhs.uk/services/e-referral-service/api/updates-and-releases/problems-and-fixes) section for more information.\n\n## Sandbox test scenarios\n\nYou can test the following scenarios in our sandbox environment:\n\n| Scenario | Request details |\n| ------------------------------------------------------------------------ | ------------------------------------- |\n| Reason for Cancellation without Comment (Comment Not Mandatory) | Intend Private With No Comment |\n| Reason for Cancellation with Comment (Comment Mandatory) | Patient Cancellation With Comment |\n| Cancelled Referral | Raised in Error |\n| Cancelled Appointment and Referral | Referrer Cancellation |\n| Cancelled Referral After Prior Appointment Cancellation | Treatment No Longer Required |\n| Cancelled Referral with Existing Review Outcome | Intend Private With Comment |\n| Cancelled Referral (Provider) without Comment (Comment Not Mandatory) | Provider Cancellation With No Comment |\n| Cancelled Referral with Triage Response | Provider Cancellation via End Triage |\n", - "summary": "Cancel referral (A036, FHIR STU3)", - "operationId": "a036-cancel-referral", - "tags": [ - "Manage referral" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the referral request\n", - "required": true, - "schema": { - "type": "string", - "example": "000000070000" - } - }, - { - "in": "header", - "name": "If-Match", - "description": "The version of the resource to be updated\n", - "required": true, - "schema": { - "type": "string", - "pattern": "^W/\"[0-9]+\"$", - "example": "W/\"4\"" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CancelReferral-Request-Parameters", - "type": "object", - "description": "Parameters containing the cancellation reason and comment for referral cancellation request.", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Request-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Request-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ------------------------------------------ |\n| `cancellationReason` | `1..1` | The reason why the referral is being cancelled |\n| `cancellationComments` | `0..1` | This may be mandatory if mandatory comment indicator is set to 'Yes' for the Cancellation Reason Type selected. Maximum 2000 characters. |\n", - "items": { - "anyOf": [ - { - "title": "cancellationReason", - "description": "Parameter to supply a cancellationReason", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "cancellationReason" - ], - "example": "cancellationReason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "INTEND_PRIVATE" - } - } - } - } - }, - { - "title": "cancellationComments", - "description": "Parameter to supply the cancellationComments", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "cancellationComments" - ], - "example": "cancellationComments" - }, - "valueString": { - "type": "string", - "example": "Patient will go to a private clinic" - } - } - } - ] - } - } - } - }, - "examples": { - "cancel-referral-without-comment": { - "summary": "Reason for Cancellation without Comment (Comment Not Mandatory)", - "value": { - "$ref": "../../examples/cancelReferral/requests/IntendPrivateWithoutComment.json" - } - }, - "cancel-referral-patient-cancellation": { - "summary": "Reason for Cancellation with Comment (Comment Mandatory)", - "value": { - "$ref": "../../examples/cancelReferral/requests/PatientRequestCancellationOther.json" - } - }, - "cancel-referral-raised-in-error": { - "summary": "Cancelled Referral", - "value": { - "$ref": "../../examples/cancelReferral/requests/RaisedInError.json" - } - }, - "cancel-referral-referrer-cancellation": { - "summary": "Cancelled Appointment and Referral", - "value": { - "$ref": "../../examples/cancelReferral/requests/ReferrerCancellation.json" - } - }, - "cancel-referral-no-longer-required": { - "summary": "Cancelled Referral After Prior Appointment Cancellation", - "value": { - "$ref": "../../examples/cancelReferral/requests/NoLongerRequired.json" - } - }, - "cancel-referral-with-reason-and-comment": { - "summary": "Cancelled Referral with Existing Review Outcome", - "value": { - "$ref": "../../examples/cancelReferral/requests/IntendPrivateWithComment.json" - } - }, - "cancel-referral-provider-without-comment": { - "summary": "Cancelled Referral (Provider) without Comment (Comment Not Mandatory)", - "value": { - "$ref": "../../examples/cancelReferral/requests/bookedOutsideCabWithoutComment.json" - } - }, - "cancel-referral-with-triage-response": { - "summary": "Cancelled Referral with Triage Response", - "value": { - "$ref": "../../examples/cancelReferral/requests/outpatientService.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "e-RS Referral Request", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CancelReferral-Response-Parameters", - "type": "object", - "description": "Parameters containing for the cancelled referral with/without cancelled appointment.", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Response-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CancelReferral-Response-Parameters-1" - } - } - } - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ---------------------------------------------------------------------------------------- |\n| `updatedReferralRequest` | `1..1` | Cancelled Referral Request . |\n| `updatedAppointment` | `0..1` | The cancelled appointment resource is only returned if appointment was cancelled part of this cancel referral operation.|\n", - "items": { - "anyOf": [ - { - "title": "updatedReferralRequest", - "description": "Parameter containing the cancelled referral request", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "updatedReferralRequest" - ], - "example": "updatedReferralRequest" - }, - "resource": { - "title": "eRS-ReferralRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "subject", - "supportingInfo", - "intent", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ReferralRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ReferralRequest" - ], - "example": "ReferralRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `eRS-Appointment` | `0..1` | |\n| `DocumentReference` | `0..*` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ----------------------------------------------------------------------- |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-Commissioning-Rule-Org` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ReferralState` | `1..1` | |\n| `Extension-eRS-Appointment` | `0..1` | |\n| `Extension-eRS-ClinicalInfoFirstSubmitted` | `0..1` | |\n| `Extension-eRS-ClinicalInfoLastUpdated` | `0..1` | |\n| `Extension-eRS-Appointment-Reference` | `0..1` | |\n| `Extension-eRS-AdditionalRequirement` | `0..3` | Outlines that this `ReferralRequest` requires an additional requirement |\n| `Extension-eRS-eReferralPathwayStart` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-Commissioning-Rule-Org", - "description": "Extension to supply the organisation any commissioning rules should utilise for a referral", - "type": "object", - "required": [ - "url", - "valueIdentifier" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Commissioning-Rule-Org-1" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralState", - "description": "Extension to outline the current state of a ReferralRequest within e-RS.", - "type": "object", - "required": [ - "url", - "extension" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralState-1" - }, - "extension": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | -------------------------------------------------------------------------------- |\n| `state` | `1..1` | Outlines the current state of the `ReferralRequest` |\n| `reason` | `0..1` | Details the reason why the `ReferralRequest` is in this state, where appropriate |\n| `comments` | `0..1` | Any comments around the current `ReferralRequest` state |\n", - "items": { - "anyOf": [ - { - "title": "Extension - Referral State", - "description": "Extension to provide the Referral State.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "state" - ], - "example": "state" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReferralState-1" - }, - "code": { - "type": "string", - "enum": [ - "REJECTED", - "CANCELLED_REFERRAL", - "DID_NOT_ATTEND", - "ASSESSMENT_RESULT", - "TRIAGE_RESPONSE", - "APPT_CANCELLED_BY_PROVIDER", - "APPT_CANCELLED_BY_PATIENT", - "AWAITING_TRIAGE", - "NOT_BOOKED", - "DEFERRED_TO_PROVIDER", - "BOOKED", - "TRIAGED_PROVIDER_TO_ACTION" - ], - "example": "APPT_CANCELLED_BY_PATIENT" - }, - "display": { - "type": "string", - "enum": [ - "Rejected", - "Cancelled Referral", - "Did Not Attend", - "Assessment Result", - "Triage Response", - "Appointment Cancelled By Provider", - "Appointment Cancelled By Patient", - "Awaiting Triage", - "Not Booked", - "Deferred To Provider", - "Booked", - "Triaged - Provider To Action" - ], - "example": "Appointment Cancelled By Patient" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason", - "description": "Extension to provide the Referral State Reason.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "reason" - ], - "example": "reason" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1'\n'https://fhir.nhs.uk/STU3/CodeSystem/eRS-AssessmentOutcome-1'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/REFERRAL-CANCELLATION-REASON'\n'_baseurl_/STU3/CodeSystem/APPOINTMENT-NON-ATTENDANCE-REASON'\n" - }, - "code": { - "type": "string", - "example": "PATIENT_ILL" - }, - "display": { - "type": "string", - "example": "Patient Ill" - } - } - } - } - }, - { - "title": "Extension - Referral State Reason Comment", - "description": "Extension to provide the Referral State Reason Comment.", - "type": "object", - "required": [ - "url", - "valueString" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "comments" - ], - "example": "comments" - }, - "valueString": { - "type": "string", - "example": "Patient could not attend appointment due to them being ill." - } - } - } - ] - } - } - } - }, - { - "title": "Extension-eRS-Appointment", - "description": "Extension to supply the appointment for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#appointment" - } - } - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoFirstSubmitted", - "description": "Date and time the clinical information was first submitted", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoFirstSubmitted-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-ClinicalInfoLastUpdated", - "description": "Date and time the clinical information was last updated", - "type": "object", - "required": [ - "url", - "valueDateTime" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ClinicalInfoLastUpdated-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - { - "title": "Extension-eRS-Appointment-Reference", - "description": "Extension to supply the appointment reference for a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Appointment-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Appointment/70000" - } - } - } - } - }, - { - "title": "Extension-eRS-AdditionalRequirement", - "description": "Indicates a patient's additional needs that they require when requesting an appointment. This e-RS feature, including the management of additional requirements and booking them, is not currently supported.", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-PatientAdditionalRequirement-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdditionalRequirementType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVOCACY", - "INTERPRETER", - "TRANSPORT" - ], - "example": "ADVOCACY" - }, - "display": { - "type": "string", - "enum": [ - "Advocacy", - "Interpreter", - "Transport" - ], - "example": "Advocacy" - } - } - } - } - }, - { - "title": "Extension-eRS-eReferralPathwayStart", - "description": "Date and time of the pathway start", - "type": "object", - "required": [ - "url", - "valueInstant" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-eReferralPathwayStart-1" - }, - "valueDateTime": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "specialty": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "maxItems": 1, - "minItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "supportingInfo": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70000" - } - } - } - }, - "intent": { - "type": "string", - "enum": [ - "plan" - ], - "example": "plan" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - } - } - }, - { - "title": "updatedAppointment", - "description": "Parameter containing the cancelled appointment", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "updatedAppointment" - ], - "example": "updatedAppointment" - }, - "resource": { - "title": "eRS-Appointment", - "description": "A booking of a healthcare event among patient(s), practitioner(s), related person(s) and/or device(s) for a specific date/time. This may result in one or more Encounter(s) (https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1)", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "description", - "incomingReferral", - "participant" - ], - "properties": { - "id": { - "type": "string", - "example": "'appointment'\n'70001'\n" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-Appointment-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Appointment-1" - } - }, - "versionId": { - "type": "string", - "nullable": true, - "example": "3" - } - } - }, - "language": { - "type": "string", - "example": "en" - }, - "resourceType": { - "type": "string", - "enum": [ - "Appointment" - ], - "example": "Appointment" - }, - "status": { - "type": "string", - "enum": [ - "proposed", - "pending", - "booked", - "arrived", - "fulfilled", - "cancelled", - "noshow" - ], - "example": "proposed" - }, - "reason": { - "nullable": true, - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "title": "eRS-ReviewReason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewReason-1" - }, - "code": { - "type": "string", - "enum": [ - "NO_SLOTS_AT_SERVICE", - "SLOT_NOT_AVAILABLE", - "BOOKING_ATTEMPT_PROBLEM", - "TRIAGE" - ], - "example": "NO_SLOTS_AT_SERVICE" - } - } - }, - { - "type": "object", - "title": "eRS-ReviewOutcome", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ReviewOutcome-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER", - "CANCEL_APPOINTMENT_ACTION_LATER", - "RETURN_TO_REFERRER_WITH_ADVICE", - "ACCEPT_REFER_BOOK_LATER" - ], - "example": "PROVIDER_CONVERTED_ADVICE_AND_GUIDANCE_ADMIN_TO_REFER" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Provider Converted Advice and Guidance, Admin to Refer" - } - } - }, - { - "type": "object", - "title": "eRS-Cancellation-Reason", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseurl_/STU3/CodeSystem/APPOINTMENT-CANCELLATION-REASON" - }, - "code": { - "type": "string", - "example": "PATIENT_HOLIDAY" - }, - "display": { - "type": "string", - "nullable": true, - "example": "Patient on holiday" - } - } - } - ] - } - } - } - } - }, - "description": { - "type": "string", - "enum": [ - "e-Referral Appointment" - ], - "example": "e-Referral Appointment" - }, - "start": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T08:30:00.000Z" - }, - "end": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "slot": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "Slot/11002001" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "created": { - "type": "string", - "nullable": true, - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "comment": { - "type": "string", - "nullable": true - }, - "incomingReferral": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "ReferralRequest/000000070000/_history/14" - } - } - }, - "minItems": 0, - "maxItems": 1 - }, - "participant": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `Patient` | `1..1` | |\n| `Service` | `1..1` | |\n| `AllocatedClinician` | `0..1` | |\n", - "items": { - "anyOf": [ - { - "type": "object", - "title": "Patient", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "Service", - "properties": { - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "nullable": true, - "example": "Cardiology Triage Business Service" - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - }, - { - "type": "object", - "title": "AllocatedClinician", - "required": [ - "type", - "actor", - "status" - ], - "properties": { - "type": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://hl7.org/fhir/ValueSet/encounter-participant-type" - ], - "example": "http://hl7.org/fhir/ValueSet/encounter-participant-type" - }, - "code": { - "type": "string", - "enum": [ - "CON" - ], - "example": "CON" - } - } - } - } - } - }, - "actor": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "accepted" - ], - "example": "accepted" - } - } - } - ] - }, - "minItems": 2, - "maxItems": 3 - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "cancelled-referral-intend-private-without-comment": { - "summary": "Cancelled Referral without Booking with Reason 'Patient will go to a private clinic' without Comment (Comment Not Mandatory)", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralIntendPrivateWithoutComment.json" - } - }, - "cancelled-referral-patient-other-reason": { - "summary": "Cancelled Referral without Booking with Reason 'Other' with Comment (Comment Mandatory)", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralPatientOther.json" - } - }, - "cancelled-referral-raised-in-error": { - "summary": "Cancelled Referral without Booking with Reason 'Referral created by mistake'", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralRaisedInError.json" - } - }, - "cancelled-referral-with-booking-referrer-cancellation": { - "summary": "Cancelled Referral with Booking with Reason 'Other - Referrer request cancellation'", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledBookedReferralReferrerCancellation.json" - } - }, - "cancelled-referral-with-cancelled-booking-no-longer-required": { - "summary": "Cancelled Referral with Cancelled Booking with Reason 'Referral no longer needed'", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralWithCancelledBookingNoLongerRequired.json" - } - }, - "cancelled-referral-with-deferral-intend-private-with-comment": { - "summary": "Cancelled Referral with Existing Review Outcome with Reason 'Patient will go to a private clinic'", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralResolvedDeferralIntendPrivateWithComment.json" - } - }, - "cancelled-referral-provider-booked-outside": { - "summary": "Cancelled Referral without Booking with Reason 'Patient booked outside NHS e-Referral Service' without Comment (Comment Not Mandatory)'", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralBookedOutsideCabWithoutComment.json" - } - }, - "cancelled-referral-provider-triaged-and-sent-to-outpatient-service": { - "summary": "Cancelled Referral with Triage Response with Reason 'Sent to outpatient service not available in this system' with Comment (Comment Mandatory)'", - "value": { - "$ref": "../../../examples/cancelReferral/responses/CancelledReferralOutpatientService.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "409": { - "description": "Conflict - Version supplied as part of the request does not match current version of the referral request" - }, - "412": { - "description": "Precondition Failed - Mandatory data is missing" - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| INVALID_REQUEST_STATE | The Request, while otherwise valid, is not in the correct state for the specific action being performed. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the request. |\n| UNABLE_TO_CANCEL_APPOINTMENT | System is unable to cancel the appointment. |\n| INAPPROPRIATE_VALUE\t | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "423": { - "description": "The NHS e-Referral Service (e-RS) implements pessimistic locking functionality in order to prevent multiple users/systems attempting to update the same resource at the same time.\n\nThe e-RS API automatically acquires the lock on the behalf of the caller, within the scope of the request. When an endpoint call is received to update a resource, that resource will be locked for the duration of the request.\n\nAPI callers should not attempt to make simultaneous requests to update the same resource. Any attempt to do so will result in a 423 (Locked) response. If a 423 response is received, then another system/user may be in the process of updating the resource. It will be necessary to fetch the resource again and re-try the request at a later time.\n" - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "502": { - "description": "Where status code 502 (Bad Gateway) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_RESPONDED_WITH_ERROR | Error received from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_RESPONDED_WITH_ERROR", - "display": "Error received from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: ERROR" - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - }, - "504": { - "description": "Where status code 504 (Gateway Timeout) is returned then an eRS-OperationOutcome-1 will be included in the body. \nCheck diagnostics property for specific information regarding the error.\nIn response to receiving this status code, it is recommended that clients retry at a later time.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| PAS_NOT_RESPONDING | No response from PAS. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "timeout", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "PAS_NOT_RESPONDING", - "display": "No response from PAS" - } - ] - }, - "diagnostics": "PAS unable to create booking into slot '11002026' for UBRN: 000000070000. PAS Request Status: TIMED_OUT" - } - ] - } - } - } - } - } - } - }, - "/R4/Practitioner": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to determine which e-RS users a `SERVICE_PROVIDER_CLINICIAN_ADMIN` is allowed to work \"on-behalf-of\".\n\nNote: In e-RS, `SERVICE_PROVIDER_CLINICIAN_ADMIN` users always act \"on-behalf-of\" a `SERVICE_PROVIDER_CLINICIAN`. This endpoint specifically helps `SERVICE_PROVIDER_CLINICIAN_ADMIN` identify who they are allowed to log in as.\n\n## Supported security patterns\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nTo use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles depending on the query being invoked:\n\n| Query | e-RS Role(s) |\n| -------------------------------------------------------------------- | --------------------------------- |\n| onBehalfOf | `SERVICE_PROVIDER_CLINICIAN_ADMIN` |\n\n## Use case\n\nAs an authenticated user who has the `SERVICE_PROVIDER_CLINICIAN_ADMIN` role\n\nI need to know which provider clinical users I am allowed to work \"on-behalf-of\" at my provider organisation\n\nSo I can log in as a `SERVICE_PROVIDER_CLINICIAN_ADMIN` user and complete tasks on behalf of a chosen `SERVICE_PROVIDER_CLINICIAN` user.\n\n## Related endpoints\n\nTo perform actions as a `SERVICE_PROVIDER_CLINICIAN_ADMIN` user, you must provide one of the returned Practitioner IDs, in the `NHSD-eRS-On-Behalf-Of-User-ID` header parameter, to indicate which `SERVICE_PROVIDER_CLINICIAN` the call is on-behalf-of.\n", - "summary": "Retrieve \"on-behalf-of\" practitioner user information (A040, FHIR R4)", - "operationId": "a040-retrieve-practitioner-info", - "tags": [ - "Retrieve user information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "query", - "name": "_query", - "description": "A mandatory URL parameter where \"onBehalfOf\" is the name of the query operation.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "onBehalfOf" - ], - "example": "onBehalfOf" - } - } - ], - "responses": { - "200": { - "description": "The response body is a `Bundle` that contains `Practitioner` entries which define the [[HYPERLINK_ERS_BUS_FUNCTIONS]] that the user has available at each `Organisation` where they have a role.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "Bundle resource containing On-Behalf-Of practitioners", - "description": "The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle \n", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "type", - "total", - "timestamp", - "link" - ], - "properties": { - "id": { - "type": "string", - "example": "08acc887-6a7b-4b38-8f50-022e41319efe" - }, - "resourceType": { - "type": "string", - "enum": [ - "Bundle" - ], - "example": "Bundle" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "total": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 1 - }, - "timestamp": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "link": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/R4/Practitioner?_query=onBehalfOf" - } - } - } - }, - "entry": { - "type": "array", - "items": { - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "Practitioner/111111111111" - }, - "resource": { - "type": "object", - "description": "A UKCore-Practitioner. The canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Practitioner", - "required": [ - "id", - "meta", - "resourceType", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "111111111111" - }, - "resourceType": { - "type": "string", - "enum": [ - "Practitioner" - ], - "example": "Practitioner" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - } - } - }, - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/sds-user-id" - ], - "example": "https://fhir.nhs.uk/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "111111111111" - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - } - } - } - } - } - }, - "examples": { - "example-response-body": { - "summary": "Example response body", - "value": { - "$ref": "../../../examples/retrieveOboUsers/responses/PractitionerBundle.json" - } - } - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------|\n| REC_BAD_REQUEST | invalid | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The query parameter _query is missing or has an invalid value. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "invalid", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_BAD_REQUEST" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-supported", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_ACCEPTABLE" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/CommunicationRequest/{ubrn}/$ers.generateCRI": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to generate a PDF file that summarises an advice and guidance request including the conversation. \nThis endpoint cannot be used to obtain a PDF file for a referral request.\n\n## Supported security patterns\n- Application-restricted access, unattended access\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\n\nYou need to use the `Unique Booking Reference Number` (UBRN) of an advice and guidance request.\n\n## Application-restricted access\nIn order to use this endpoint you must be an authenticated e-RS calling application, working in the context of a Service Provider Organisation.\n\n## Healthcare worker, user-restricted access\nIn order to use this endpoint you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n - `SERVICE_PROVIDER_CLINICIAN`\n - `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\n## Important note\n\nAn advice and guidance request may have been converted to a referral (with the same UBRN), \nand in addition a referral pathway in e-RS can be made up of more than one UBRN. \nAs such, it is important that all clinical information is obtained across all the related UBRNs in the pathway. \nThese can be identified using [[HYPERLINK_A005]].\n\nIf the converted advice and guidance request is referred to a service outside of your organisation, \nthe subsequent referral information may not be accessible due to legitimate relationship rules. \nHowever, the advice and guidance summary ([[HYPERLINK_A024]]), \nattachments ([[HYPERLINK_A006]]), advice and guidance conversation ([[HYPERLINK_A025]]) and \nclinical information ([[HYPERLINK_A043]]) which took place before such a conversion still forms part of the clinical information and can still be retrieved.\n\n## Use case\n\nAs an authenticated user or application\n\nI need to retrieve a PDF file overview of the advice and guidance request\n\nSo that I can assess its content and decide what further action may be needed.\n\n## Related endpoints\nYou can retrieve a PDF overview for an advice and guidance request that has been converted to a referral using [[HYPERLINK_A007]].\n\nYou can retrieve structured information about advice and guidance using [[HYPERLINK_A024]] and [[HYPERLINK_A025]].\n\nYou can retrieve a referral using [[HYPERLINK_A005]].\n\nYou can retrieve clinical attachments that are associated with a referral using [[HYPERLINK_A006]].\n", - "summary": "Retrieve advice and guidance overview PDF (A043, FHIR STU3)", - "operationId": "a043-retrieve-advice-and-guidance-overview-pdf", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access.\n", - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC.\n\nNot allowed for application-restricted access.\n\nRequired for user-restricted access where the Service Provider Clinician Admin Business Function is used for authentication.\n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "name": "ubrn", - "in": "path", - "description": "The unique booking reference number of the advice and guidance request\n", - "required": true, - "schema": { - "type": "string", - "example": "000049146177" - } - } - ], - "responses": { - "200": { - "description": "Response contains the binary stream of the advice and guidance overview PDF.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Disposition": { - "description": "The description of the type of content provided.\n", - "required": true, - "schema": { - "type": "string", - "example": "attachment; filename=\"000049146177_Advice_And_Guidance_20220610143044.pdf\"" - } - }, - "Content-Length": { - "description": "The length of the response.\n", - "required": true, - "schema": { - "type": "string", - "example": "3111" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/pdf" - ], - "example": "application/pdf" - } - } - }, - "content": { - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "404": { - "description": "Not Found" - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------- |\n| INVALID_REQUEST_TYPE | The `UBRN` provided exists in e-RS but does not correspond to an advice and guidance request. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| NO_RELATIONSHIP | The user does not have a legitimate relationship with the advice and guidance request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/STU3/CommunicationRequest/$ers.createAdviceAndGuidance": { - "post": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\nUse this endpoint to create an advice and guidance request from a referring organisation to a service providing organisation.\n\nAn advice and guidance request includes important contextual information. For example, the service and specialty to which advice has been requested. Creating the request also starts the conversation between a referrer seeking advice and a provider from whom the advice is sought.\n\nConversation messages can include attachments.\n\n## Supported security patterns\n\nHealthcare worker, user-restricted access\n\n## Important notes\n\nThe maximum number of services allowed on a given shortlist is 1.\n\nIn order to retrieve an attachment using the [[HYPERLINK_A042]] (or deprecated [[HYPERLINK_A006]]) endpoint, the attachment must be available for download. \nThe availability status of attachments associated with a referral are returned via this endpoint as a eRS-AvailabilityStatus-1 code. \n\nFurther details on attachment availability status and eRS-AvailabilityStatus-1 codes can be found in the [[HYPERLINK_A024]], [[HYPERLINK_A025]] and [[HYPERLINK_A042]] specifications.\n\n## Pre-requisites\nTo use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles:\n - `REFERRING_CLINICIAN`\n - `REFERRING_CLINICIAN_ADMIN`\n\nYou need to have identified a patient, for example via [[HYPERLINK_PDS]].\n\nYou need to have found services that meet the referral needs of a patient using [[HYPERLINK_A010]].\n\nIf you want to include attachments with the request, you need to use [[HYPERLINK_A020]] so they are ready to be associated with the request.\n\n## Use case\n\nAs an authenticated user \n\nI need to request some advice from a given service\n\nSo I can either initiate my patient's referral pathway or provide recommended treatment.\n\n## Related endpoints\n\nProviders are able to respond to an advice and guidance request via [[HYPERLINK_A026]] or convert the advice and guidance request into a referral via [[HYPERLINK_A027]].\n\nReferrers and providers can use:\n\n[[HYPERLINK_A024]] to retrieve the summary of an advice and guidance request\n\n[[HYPERLINK_A025]] to retrieve the advice and guidance conversation.\n", - "summary": "Create advice and guidance request (A044, FHIR STU3)", - "operationId": "a044-create-advice-and-guidance-request", - "tags": [ - "Request advice" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "REFERRING_CLINICIAN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - } - ], - "requestBody": { - "required": true, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CreateAdviceAndGuidance-Request-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Request-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Request-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `patient` | `1..1` | The patient the Advice request relates to. |\n| `providerConversionAuthorisation` | `1..1` | A flag detailing whether or not the provider who deals with this advice request is authorised to convert this Advice Request into a Referral |\n| `shortlist` | `1..1` | A list of services where the Advice Request should be sent to. Note currently only shortlists with a single Service included are supported. |\n| `request` | `1..1` | An initial message outlining the request. Maximum 8000 characters. |\n| `referringClinician` | `0..1` | Detail the Referring Clinician that a Referring Clinician Admin is acting on behalf off. Only permitted when creating an Advice Request as a user using the Referring Clinician Admin business function where it is also mandatory. |\n| `requestAttachmentFile` | `0..*` | A set of attachments to be included with the initial request. |\n", - "items": { - "anyOf": [ - { - "title": "Patient", - "description": "Parameter to supply a patient", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "patient" - ], - "example": "patient" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - { - "title": "ProviderConversionAuthorisation", - "description": "Parameter to define the Provider's conversion authorisation", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "providerConversionAuthorisation" - ], - "example": "providerConversionAuthorisation" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - }, - "code": { - "type": "string", - "enum": [ - "AUTHORISED_TO_CONVERT", - "NOT_AUTHORISED_TO_CONVERT" - ], - "example": "AUTHORISED_TO_CONVERT" - } - } - } - } - }, - { - "title": "Shortlist", - "description": "Parameter to supply a shortlist", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "shortlist" - ], - "example": "shortlist" - }, - "resource": { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - } - } - }, - { - "title": "request", - "description": "Parameter to supply a request", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "request" - ], - "example": "request" - }, - "valueString": { - "type": "string", - "example": "Please provide some advice around this case." - } - } - }, - { - "title": "ReferringClinician", - "description": "Parameter to supply a referring clinician", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "referringClinician" - ], - "example": "referringClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "requestAttachmentFile", - "description": "Parameter to supply an attachment alongside a request", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "requestAttachmentFile" - ], - "example": "requestAttachmentFile" - }, - "resource": { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "ADVICE_REQUEST" - ], - "example": "ADVICE_REQUEST" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "url" - ], - "properties": { - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - } - } - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "rca-with-attachments": { - "summary": "Example created by RCA with attachments authorising the provider to convert to a referral request.", - "value": { - "$ref": "../../examples/createAdviceAndGuidance/requests/ExampleRCAWithAttachments.json" - } - }, - "rc-without-attachments": { - "summary": "Example created by RC without attachments not authorising the provider to convert to a referral request.", - "value": { - "$ref": "../../examples/createAdviceAndGuidance/requests/ExampleRCWithoutAttachments.json" - } - } - } - } - } - }, - "responses": { - "200": { - "description": "An Advice And Guidance Request created within e-RS.", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-CreateAdvice-Response-Parameters", - "type": "object", - "required": [ - "resourceType", - "meta", - "parameter" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ] - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Response-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CreateAdviceAndGuidance-Response-Parameters-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "parameter": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| --------------------------------- | ----------- | -------------------------------------------------------------|\n| `createdCommunicationRequest` | `1..1` | The created Advice And Guidance Request summary resource. |\n| `createdCommunication` | `1..1` | The created Initial Request message within the conversation. |\n", - "items": { - "anyOf": [ - { - "title": "createdCommunicationRequest", - "description": "The created Advice Request summary resource.", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "createdCommunicationRequest" - ], - "example": "createdCommunicationRequest" - }, - "resource": { - "title": "eRS-CommunicationRequest", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "contained", - "extension", - "status", - "category", - "subject", - "recipient", - "sender", - "requester", - "identifier" - ], - "properties": { - "id": { - "type": "string", - "example": "000000070000" - }, - "meta": { - "type": "object", - "required": [ - "profile", - "versionId" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-CommunicationRequest-1" - } - }, - "versionId": { - "type": "string", - "example": "3" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "CommunicationRequest" - ], - "example": "CommunicationRequest" - }, - "contained": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-Shortlist-List` | `1..1` | |\n| `eRS-ServiceSearchCriteria-Parameters` | `1..1` | |\n| `DocumentReference` | `0..*` | |\n| `CareConnect-PractitionerRole` | `1..2` | |\n", - "items": { - "anyOf": [ - { - "title": "eRS-Shortlist-List", - "description": "A list of services representing the services available to the patient to have treatment at", - "type": "object", - "required": [ - "status", - "mode", - "meta", - "resourceType", - "entry" - ], - "properties": { - "id": { - "type": "string", - "example": "shortlist" - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "mode": { - "type": "string", - "enum": [ - "snapshot" - ], - "example": "snapshot" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Shortlist-List-1" - } - } - } - }, - "contained": { - "type": "array", - "items": { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - } - }, - "extension": { - "type": "array", - "nullable": true, - "maxItems": 1, - "minItems": 1, - "description": "\n| Field | Cardinality | Notes |\n| ------------------------------------------ | ----------- | ------------------------------------------------------------------------------ |\n| `Extension-eRS-Shortlist-SearchCriteria` | `1..1` | The `SearchCriteria` used to retrieve the services included in the `Shortlist` |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-Shortlist-SearchCriteria", - "description": "Extension to detail the `SearchCriteria` associated with a `Shortlist`", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Shortlist-SearchCriteria-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#serviceSearchCriteria" - } - } - } - } - } - ] - } - }, - "resourceType": { - "type": "string", - "enum": [ - "List" - ], - "example": "List" - }, - "entry": { - "type": "array", - "items": { - "title": "Singular entry with service details", - "type": "object", - "required": [ - "item" - ], - "properties": { - "item": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - }, - "display": { - "type": "string", - "example": "Good Cardiology Business Service" - } - } - } - } - }, - "minItems": 1, - "maxItems": 20 - } - } - }, - { - "title": "eRS-ServiceSearchCriteria-Parameters", - "description": "The criteria used to search for services", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "parameter" - ], - "properties": { - "id": { - "type": "string", - "example": "serviceSearchCriteria" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-ServiceSearchCriteria-Parameters-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Parameters" - ], - "example": "Parameters" - }, - "parameter": { - "type": "array", - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------------------------------------------------------- |\n| `Priority` | `1..1` | |\n| `Specialty` | `0..1` | |\n| `ClinicType` | `0..1` | |\n| `IndicativeAppointmentWaitTimeLimit` | `0..1` | |\n| `Postcode` | `0..1` | |\n| `DistanceLimit` | `0..1` | |\n| `ClinicalTerm` | `0..1` | |\n| `NamedClinician` | `0..1` | |\n| `AgeAndGenderAppropriate` | `1..1` | Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language. |\n| `CommissioningProvisioning` | `0..1` | This filter parameter is no longer supported as an input. If provided it will be ignored and a value of `ALL_AVAILABLE_FOR_BOOKING` used. Stored historical values will continue to be returned for output. |\n| `Organisation` | `0..1` | This parameter is not included in the response when retrieving the service search criteria. |\n| `Place` | `0..1` | Only supported in read mode, search by `place` is not possible currently. |\n", - "items": { - "anyOf": [ - { - "title": "Priority", - "description": "Details the priority parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "priority" - ], - "example": "priority" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - }, - { - "title": "Specialty", - "description": "Details the specialty parameter", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "specialty" - ], - "example": "specialty" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - } - } - } - } - }, - { - "title": "ClinicType", - "description": "Details the clinic type that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicType" - ], - "example": "clinicType" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ClinicType-1" - }, - "code": { - "type": "string", - "example": "HEART_FAILURE" - } - } - } - } - }, - { - "title": "IndicativeAppointmentWaitTimeLimit", - "description": "Details the indicative appointment wait time limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "indicativeAppointmentWaitTimeLimit" - ], - "example": "indicativeAppointmentWaitTimeLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 50 - } - } - }, - { - "title": "Postcode", - "description": "Details the postcode value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "postcode" - ], - "example": "postcode" - }, - "valueString": { - "type": "string", - "example": "LS1 2UT" - } - } - }, - { - "title": "DistanceLimit", - "description": "Details the distance limit value specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueUnsignedInt" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "distanceLimit" - ], - "example": "distanceLimit" - }, - "valueUnsignedInt": { - "type": "integer", - "minimum": 0, - "format": "int32", - "example": 123 - } - } - }, - { - "title": "ClinicalTerm", - "description": "Details the clinical term that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "clinicalTerm" - ], - "example": "clinicalTerm" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://snomed.info/sct" - ], - "example": "http://snomed.info/sct" - }, - "code": { - "type": "string", - "example": "1003" - } - } - } - } - }, - { - "title": "NamedClinician", - "description": "Details the named clinician that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "namedClinician" - ], - "example": "namedClinician" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - { - "title": "AgeAndGenderAppropriate", - "description": "Details the age and sex appropriate flag used in a search criteria. Content in the e-RS Professional Application has changed to replace 'Gender' with 'Sex'. This represents the data better and uses inclusive language.", - "type": "object", - "required": [ - "name", - "valueBoolean" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "ageAndGenderAppropriate" - ], - "example": "ageAndGenderAppropriate" - }, - "valueBoolean": { - "type": "boolean", - "example": true - } - } - }, - { - "title": "CommissioningProvisioning", - "description": "Details the commissioning provisioning flag detailed in a search criteria", - "type": "object", - "required": [ - "name", - "valueCoding" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "commissioningProvisioning" - ], - "example": "commissioningProvisioning" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommissioningProvisioning-1" - }, - "code": { - "type": "string", - "enum": [ - "ALL_AVAILABLE_FOR_BOOKING", - "ALL_SERVICES", - "LOCALLY_COMMISSIONABLE", - "NATIONALLY_AVAILABLE" - ], - "example": "ALL_AVAILABLE_FOR_BOOKING" - } - } - } - } - }, - { - "title": "Organisation", - "description": "Details the organisation that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueIdentifier" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "organisation" - ], - "example": "organisation" - }, - "valueIdentifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://directory.spineservices.nhs.uk/STU3/Organization" - ], - "example": "https://directory.spineservices.nhs.uk/STU3/Organization" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - { - "title": "Place", - "description": "Details the place that was specified in a search criteria", - "type": "object", - "required": [ - "name", - "valueString" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "place" - ], - "example": "place" - }, - "valueString": { - "type": "string", - "example": "Leeds" - } - } - } - ] - } - } - } - }, - { - "title": "DocumentReference", - "description": "A reference to a document", - "type": "object", - "required": [ - "meta", - "resourceType", - "type", - "status", - "indexed", - "content" - ], - "properties": { - "id": { - "type": "string", - "example": "DocumentReference-70002" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-DocumentReference-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "DocumentReference" - ], - "example": "DocumentReference" - }, - "type": { - "type": "object", - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AttachmentType-1" - }, - "code": { - "type": "string", - "enum": [ - "REFERRER", - "PROVIDER", - "ADVICE_REQUEST", - "GUIDANCE_RESPONSE" - ], - "example": "REFERRER" - }, - "display": { - "type": "string", - "enum": [ - "Referrer", - "Provider", - "Advice Request", - "Guidance Response" - ], - "example": "Referrer" - } - } - } - } - } - }, - "status": { - "type": "string", - "enum": [ - "current" - ], - "example": "current" - }, - "indexed": { - "type": "string", - "format": "date-time", - "example": "2021-04-22T10:00:00.000Z" - }, - "description": { - "type": "string", - "nullable": true, - "example": "upload png" - }, - "content": { - "type": "array", - "minItems": 1, - "items": { - "type": "object", - "required": [ - "attachment" - ], - "properties": { - "attachment": { - "title": "A reference to an already created Attachment (http://hl7.org/fhir/stu3/datatypes.html#Attachment)", - "type": "object", - "required": [ - "contentType", - "url", - "size", - "title", - "creation" - ], - "properties": { - "id": { - "type": "string", - "example": "70002" - }, - "contentType": { - "type": "string", - "example": "image/png" - }, - "url": { - "type": "string", - "example": "Binary/19eb7224-dff3-4730-a5cb-67eac811f1a5" - }, - "size": { - "type": "integer", - "example": 6 - }, - "title": { - "type": "string", - "example": "upload.png" - }, - "creation": { - "type": "string", - "format": "date", - "example": "2021-04-22" - }, - "extension": { - "type": "array", - "minItems": 2, - "maxItems": 4, - "description": "\n| Field | Cardinality | Notes |\n| --------------------------------------- | ----------- | ------------------------------------------ |\n| `eRS-AvailabilityStatus` | `1..1` | |\n| `eRS-AttachedBy` | `1..1` | |\n| `eRS-AttachedByOrganisation` | `0..1` | |\n| `AttachedOnBehalfOf` | `0..1` | |\n", - "items": { - "oneOf": [ - { - "title": "Extension-eRS-AvailabilityStatus", - "description": "Details whether a file is available to be downloaded. See the Important note section for further information", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AvailabilityStatus-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AvailabilityStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "AVAILABLE", - "PENDING", - "THREATS_FOUND", - "VALIDATION_FAILED" - ], - "example": "AVAILABLE" - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedBy", - "description": "Extension to indicate the individual who attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedBy-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-AttachedByOrganisation", - "description": "Extension to indicate the organisation that attached a file within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedByOrganisation-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-OnBehalfOf", - "description": "Extension to indicate the individual on whose behalf a file was attached within e-RS.", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-AttachedOnBehalfOf-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - } - } - } - ] - } - } - } - } - } - } - } - } - }, - { - "title": "CareConnect-PractitionerRole", - "description": "The PractitionerRole resource represents a specific set of Roles/Locations/specialties/services that a practitioner may perform at an organization for a period of time.", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "practitioner", - "organization" - ], - "properties": { - "id": { - "type": "string", - "example": "PractitionerRole-R69-000000000101" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - ], - "example": "https://fhir.hl7.org.uk/STU3/StructureDefinition/CareConnect-PractitionerRole-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "PractitionerRole" - ], - "example": "PractitionerRole" - }, - "practitioner": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/sds-user-id" - ], - "example": "http://fhir.nhs.net/Id/sds-user-id" - }, - "value": { - "type": "string", - "example": "021600556514" - } - } - } - } - }, - "organization": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - }, - "code": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-BusinessFunction-1" - }, - "code": { - "type": "string", - "example": "REFERRING_CLINICIAN" - } - } - } - } - } - } - } - } - } - ] - } - }, - "extension": { - "type": "array", - "nullable": true, - "description": "\n| Field | Cardinality | Notes |\n| ----------------------------------------------- | ----------- | ------------------------------------------ |\n| `Extension-eRS-ReferralShortlist` | `1..1` | |\n| `Extension-eRS-ReferralPriority` | `1..1` | |\n| `Extension-eRS-ProviderConversionAuthorisation` | `1..1` | |\n| `Extension-eRS-Specialty` | `1..1` | |\n", - "items": { - "anyOf": [ - { - "title": "Extension-eRS-ReferralShortlist", - "description": "Extension to supply the current shortlist for a ReferralRequest", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralShortlist-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#shortlist" - } - } - } - } - }, - { - "title": "Extension-eRS-ReferralPriority", - "description": "Extension to supply the current priority of a ReferralRequest within e-RS", - "type": "object", - "required": [ - "url", - "valueCodeableConcept" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ReferralPriority-1" - }, - "valueCodeableConcept": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-Priority-1" - }, - "code": { - "type": "string", - "enum": [ - "ROUTINE", - "URGENT", - "TWO_WEEK_WAIT" - ], - "example": "URGENT" - }, - "display": { - "description": "display value is returned in response from the server", - "nullable": true, - "type": "string", - "example": "Urgent" - } - } - } - } - } - } - } - }, - { - "title": "Extension-eRS-ProviderConversionAuthorisation", - "description": "Extension to supply the conversion authorisation flag", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-ProviderConversionAuthorisation-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-ProviderConversionAuthorisation-1" - }, - "code": { - "type": "string", - "enum": [ - "AUTHORISED_TO_CONVERT", - "NOT_AUTHORISED_TO_CONVERT" - ], - "example": "NOT_AUTHORISED_TO_CONVERT" - }, - "display": { - "type": "string", - "example": "Referrer has NOT allowed the Service Provider to convert the Advice and Guidance to a Referral" - } - } - } - } - }, - { - "title": "Extension-eRS-Specialty", - "description": "Extension to supply the specialty", - "type": "object", - "required": [ - "url", - "valueCoding" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-eRS-Specialty-1" - }, - "valueCoding": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "example": "_baseUrl_/STU3/CodeSystem/SPECIALTY" - }, - "code": { - "type": "string", - "example": "CARDIOLOGY" - }, - "display": { - "type": "string", - "example": "Cardiology" - } - } - } - } - } - ] - } - }, - "status": { - "type": "string", - "enum": [ - "active", - "cancelled", - "completed" - ], - "example": "active" - }, - "category": { - "type": "array", - "nullable": true, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-AdviceAndGuidanceStatus-1" - }, - "code": { - "type": "string", - "enum": [ - "PROVIDER_RESPONSE_REQUIRED", - "REFERRER_TO_SUBMIT_FURTHER_INFORMATION", - "REFERRER_TO_REVIEW_RESPONSE", - "CONVERSATION_ENDED_CANCELLED", - "CONVERSATION_ENDED_CLOSED", - "ADVICE_CONVERTED" - ], - "example": "PROVIDER_RESPONSE_REQUIRED" - } - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/nhs-number" - ], - "example": "http://fhir.nhs.net/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - }, - "recipient": { - "type": "array", - "items": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - } - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "requester": { - "type": "object", - "required": [ - "agent" - ], - "properties": { - "agent": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#DocumentReference-70002" - } - } - } - } - } - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "enum": [ - "https://fhir.nhs.uk/Id/ers-request-id" - ], - "example": "https://fhir.nhs.uk/Id/ers-request-id" - }, - "value": { - "type": "string", - "example": "a.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - } - } - } - } - } - } - } - }, - { - "title": "createdCommunication", - "description": "The created initial request message within the conversation.", - "type": "object", - "required": [ - "name", - "resource" - ], - "properties": { - "name": { - "type": "string", - "enum": [ - "createdCommunication" - ], - "example": "createdCommunication" - }, - "resource": { - "title": "eRS-Communication-1", - "description": "A record of information transmitted from a sender to a receiver", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "status", - "category", - "recipient", - "sent", - "sender", - "note" - ], - "properties": { - "id": { - "type": "string", - "example": "appointment" - }, - "meta": { - "type": "object", - "required": [ - "profile" - ], - "properties": { - "profile": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1", - "https://fhir.hl7.org.uk/STU3/StructureDefinition/eRS-Communication-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-Communication-1" - } - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "Communication" - ], - "example": "Communication" - }, - "status": { - "type": "string", - "enum": [ - "completed" - ], - "example": "completed" - }, - "category": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-CommunicationSentBy-1" - }, - "code": { - "type": "string", - "enum": [ - "REQUESTER", - "RESPONDER", - "REFERRER_CLINICAL_INFORMATION_UPDATED" - ], - "example": "REQUESTER" - } - } - } - } - } - } - }, - "recipient": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "anyOf": [ - { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-HealthcareService-Reference", - "description": "Extension to supply the service id", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-HealthcareService-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "http://fhir.nhs.net/Id/ers-service" - ], - "example": "http://fhir.nhs.net/Id/ers-service" - }, - "value": { - "type": "string", - "example": "11002" - } - } - } - } - } - } - } - } - } - }, - { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/ods-organization-code" - ], - "example": "https://fhir.nhs.uk/Id/ods-organization-code" - }, - "value": { - "type": "string", - "example": "R69" - } - } - } - } - } - ] - } - }, - "sent": { - "type": "string", - "format": "date-time", - "example": "2021-04-20T12:17:35.128Z" - }, - "sender": { - "type": "object", - "required": [ - "extension" - ], - "properties": { - "extension": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "title": "Extension-PractitionerRole-Reference", - "description": "Extension to supply practitioner details", - "type": "object", - "required": [ - "url", - "valueReference" - ], - "properties": { - "url": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/Extension-PractitionerRole-Reference-1" - }, - "valueReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "#PractitionerRole.021600556514.R68.REFERRING-CLINICIAN" - } - } - } - } - } - } - } - }, - "payload": { - "type": "array", - "items": { - "type": "object", - "required": [ - "contentReference" - ], - "properties": { - "contentReference": { - "type": "object", - "required": [ - "reference" - ], - "properties": { - "reference": { - "type": "string", - "example": "DocumentReference/70000" - } - } - } - } - } - }, - "note": { - "type": "array", - "minItems": 1, - "maxItems": 1, - "items": { - "type": "object", - "required": [ - "text" - ], - "properties": { - "text": { - "type": "string", - "example": "Example content...", - "description": "Maximum 8000 characters." - } - } - } - } - } - } - } - } - ] - } - } - } - }, - "examples": { - "rca-with-attachments": { - "summary": "Example created by RCA with attachments authorising the provider to convert to a referral request.", - "value": { - "$ref": "../../../examples/createAdviceAndGuidance/responses/ExampleRCAWithAttachments.json" - } - }, - "rc-without-attachments": { - "summary": "Example created by RC without attachments not authorising the provider to convert to a referral request.", - "value": { - "$ref": "../../../examples/createAdviceAndGuidance/responses/ExampleRCWithoutAttachments.json" - } - } - } - } - } - }, - "400": { - "description": "Bad Request" - }, - "401": { - "description": "Where status code 401 (Unauthorised) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| NO_ACCESS |
  • login
  • forbidden
| [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "NO_ACCESS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| FORBIDDEN | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| NO_ACCESS | forbidden | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "FORBIDDEN", - "display": "Forbidden" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Not Acceptable", - "headers": { - "Content-Type": { - "description": "Indicates the media type of the associated resource. \n", - "schema": { - "type": "string", - "enum": [ - "text/plain;charset=utf-8" - ], - "example": "text/plain;charset=utf-8" - } - } - }, - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "415": { - "description": "Unsupported Media Type", - "content": { - "text/plain;charset=utf-8": { - "schema": { - "type": "string" - } - } - } - }, - "422": { - "description": "Where status code 422 (Unprocessable Entity) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| Error code | Description |\n| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |\n| REFERENCE_NOT_FOUND | A supplied reference could not be resolved to valid resource (e.g. a patient, clinician or an organisation). |\n| INAPPROPRIATE_VALUE | A value, which is acceptable under different conditions, is inappropriate in the context of the other information provided. |\n| TOO_MANY_ITEMS | In a list where a maximum number of items is specified (e.g. a Shortlist), too many entries are supplied. |\n| MISSING_VALUE | A field defined as mandatory for an endpoint has not been provided. |\n| VALUE_IS_REQUIRED | A business rule defines a value as mandatory but it has not been provided. |\n| FIELD_NOT_PERMITTED | A business rule defines a field as not permitted but it has been provided. |\n| PATIENT_ERROR | An error occurred while retrieving the requested patient. Do not attempt again. |\n| INVALID_VALUE | The input provided does not conform to the expected data types and format. |\n| INVALID_CODE | The input provided for a field is not one of the defined legal values. |\n| UNEXPECTED_FIELD | A field is provided that is not expected as part of the request. E.g. a field is mis-spelt, was defined on a previous version of the endpoint but has subsequently been removed. |\n| INVALID_FHIR_STRUCTURE | The FHIR data structure in the message body does not match the expected structure (e.g. an array is present for a value when no array is expected). |\n| REFERENCED_USER_IS_NOT_SPC | The user provided does not have the Service Provider Clinician authorisation in the e-RS. |\n| ORGANISATION_IS_CLOSED | The organisation supplied corresponds to an organisation that is closed. |\n| ORGANISATION_NOT_APPROPRIATE | The organisation supplied corresponds to an organisation that is not valid for the given request. |\n| DUPLICATE_SERVICE | Unique service value expected. |\n| SHORTLISTED_SERVICE_NOT_IN_RESULTS | The service selected for the shortlist submitted does not satisfy the search criteria provided. |\n| REFERENCED_USER_IS_NOT_ACTIVE | The user identified is not active. |\n| REFERENCED_USER_NOT_IN_ORG | The referenced user does not belong to organisation specified. |\n| NO_REG_GP_PRACTICE | The patient provided was found not to have a registered GP practice in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC | The user provided does not have the Referring Clinician authorisation in the e-RS. |\n| REFERENCED_USER_IS_NOT_RC_AT_ORG | The user provided does not have the Referring Clinician authorisation at the organisation specified. |\n| SNOMED_NOT_FOUND | A SNOMED code, while potentially valid in the latest version of the international dictionary, is not found in the e-RS dictionary. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "value", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "UNEXPECTED_FIELD", - "display": "Unexpected field" - } - ] - }, - "diagnostics": "'parameter[0]/resource/contained[0]/parameter[1]' (unknownParameter) unknown parameter name" - } - ] - } - } - } - }, - "429": { - "description": "The e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n" - }, - "500": { - "description": "Internal Server Error" - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an eRS-OperationOutcome-1 will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| Error code | Description |\n| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |\n| SYSTEM_UNAVAILABLE | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "eRS-OperationOutcome", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "properties": { - "profile": { - "type": "array", - "items": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ], - "example": "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - }, - "minItems": 1, - "maxItems": 1 - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "example": "error" - }, - "code": { - "type": "string", - "example": "business-rule" - }, - "diagnostics": { - "type": "string", - "example": "'Shortlist/Service Id' (11002) cannot be added to a shortlist more than once." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code", - "display" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ], - "example": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - }, - "code": { - "type": "string", - "example": "DUPLICATE_SERVICE" - }, - "display": { - "type": "string", - "example": "Duplicate service found in shortlist" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "meta": { - "profile": [ - "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ] - }, - "resourceType": "OperationOutcome", - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1", - "code": "SYSTEM_UNAVAILABLE", - "display": "System Unavailable" - } - ] - } - } - ] - } - } - } - } - } - } - }, - "/R4/ServiceRequest": { - "get": { - "security": [ - { - "bearerAuth": [] - } - ], - "description": "## Overview\n\n

\nWarning: This endpoint is part of a new suite of APIs currently in development. We currently advise against integrating with this endpoint as its definition may be subject to change. If you would still like to use this endpoint please contact us before you start integration.\n

\n\nThe e-RS FHIR API represents an advice and guidance request and a referral in FHIR R4 as a ServiceRequest. This endpoint allows you to search for attributes about a ServiceRequest.\n\nAt present the following is the only permitted use case for using this endpoint, but it is expected that additional use cases will be added as future needs are identified and prioritised.\n- For FHIR R4 endpoints, the e-RS FHIR API requires a unique identifier for the ServiceRequest, instead of the UBRN, to identify an advice and guidance request or referral request. To support partners to transition from previous FHIR versions, and utilise the newer FHIR endpoints, this endpoint can be used as a bridging mechanism so that you can search for the required unique identifiers using a UBRN. \n\n## Supported security patterns\n\n- Healthcare worker, user-restricted access\n\n## Pre-requisites\nTo use this endpoint, you must be an authenticated e-RS user and use one of the following e-RS roles:\n\n- `REFERRING_CLINICIAN`\n- `REFERRING_CLINICIAN_ADMIN`\n- `SERVICE_PROVIDER_CLINICIAN`\n- `SERVICE_PROVIDER_CLINICIAN_ADMIN`\n\nYou need to use the Unique Booking Reference Number (UBRN) of an advice and guidance request or referral request.\n\n\n## Important notes\n\nWhen searching for a unique identifier for a ServiceRequest, it's important to note that one UBRN can relate to both an advice and guidance request and a referral. In this case, the response could contain two unique identifiers: one relating to the advice and guidance request and one relating to the referral.\n\n## Use case\n\nAs an authenticated user\n\nI need the unique identifier for a given advice and guidance request or referral request\n\nSo that I can view or action an advice and guidance request or referral\n\n## Related endpoints\n\nOnce the ServiceRequest's unique identifier has been retrieved it can then be used to call the following endpoints to manage its clinical attachments:\n- [[HYPERLINK_A012]]\n\n## Sandbox test scenarios\nYou can test the following scenarios in our sandbox environment\n\n| Scenario | UBRN |\n| --------------------------------------------------------------------------------------- | -------------- |\n| A response containing a single Request ID for a `ServiceRequest` of category `referral` | `000000070000` |\n| A response containing a single Request ID for a `ServiceRequest` of category `request` | `000000070001` |\n| A response containing two Request IDs | `000000070002` |\n| A response containing an empty bundle | `000000070003` |\n", - "summary": "Search for service requests (A041, FHIR R4)", - "operationId": "a041-search-service-request", - "tags": [ - "Retrieve clinical information" - ], - "parameters": [ - { - "in": "header", - "name": "Authorization", - "description": "An [OAuth 2.0 bearer token](https://digital.nhs.uk/developer/guides-and-documentation/security-and-authorisation#user-restricted-apis).\n\nRequired in all environments except sandbox.\n", - "required": true, - "schema": { - "type": "string", - "format": "^Bearer\\ [[:ascii:]]+$", - "example": "Bearer g1112R_ccQ1Ebbb4gtHBP1aaaNM" - } - }, - { - "in": "header", - "name": "NHSD-eRS-Business-Function", - "description": "The e-RS Business Function of the caller\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "REFERRING_CLINICIAN", - "REFERRING_CLINICIAN_ADMIN", - "REFERRING_ADMIN", - "COMMISSIONER", - "SERVICE_PROVIDER_CLINICIAN_ADMIN", - "SERVICE_PROVIDER_CLINICIAN", - "SERVICE_PROVIDER_ADMIN", - "INFORMATION_ANALYST", - "BOOKING_MANAGER", - "ADDITIONAL_REQUIREMENTS_MANAGER" - ], - "example": "SERVICE_PROVIDER_CLINICIAN_ADMIN" - } - }, - { - "in": "header", - "name": "X-Correlation-ID", - "description": "Arbitrary string value provided by API Consumer\n\nTends to be unique, but does not have to be\n\nReturned, unchanged, in the response\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - { - "in": "header", - "name": "NHSD-End-User-Organisation-ODS", - "description": "The ODS code of the caller's Organisation\n", - "required": true, - "schema": { - "type": "string", - "example": "R69" - } - }, - { - "in": "header", - "name": "NHSD-eRS-On-Behalf-Of-User-ID", - "description": "The (SDS) user ID of the user that the authenticating user wishes to act on behalf of (OBO). \n\n\"On behalf of\" is only supported for a Service Provider Clinician Admin (SPCA) acting on behalf of a Service Provider Clinician (SPC). \n\nWhere an OBO User ID is supplied the authenticating user must be an SPCA and the OBO User ID must be that of an appropriate SPC. \n", - "required": false, - "schema": { - "type": "string", - "example": "021600556514" - } - }, - { - "name": "identifier", - "in": "query", - "description": "The Unique Booking Reference Number (UBRN) used to search for `ServiceRequest` resources.\nThe format follows that of a [token](https://www.hl7.org/fhir/r4/search.html#token), with `code` (UBRN) being mandatory and `system` being optional.\nIn this case, the code system will be eRS UBRN (https://fhir.nhs.uk/Id/UBRN).\n- [parameter]=[code]\n- [parameter]=[system]|[code]\n", - "required": true, - "style": "form", - "explode": false, - "schema": { - "type": "string", - "format": "token" - }, - "examples": { - "system_and_ubrn": { - "value": "https://fhir.nhs.uk/Id/UBRN|000000070000", - "summary": "Code system and UBRN" - }, - "ubrn": { - "value": "000000070000", - "summary": "UBRN only" - } - } - } - ], - "responses": { - "200": { - "description": "Bundle resource containing the `ServiceRequest` resources associated to the supplied UBRN. \nThe canonical URL: https://fhir.hl7.org.uk/StructureDefinition/UKCore-Bundle\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "type": "object", - "required": [ - "id", - "meta", - "type", - "timestamp", - "total", - "link" - ], - "properties": { - "id": { - "type": "string", - "example": "123e4567-e89b-12d3-a456-426614174000" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "type": { - "type": "string", - "enum": [ - "searchset" - ], - "example": "searchset" - }, - "timestamp": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - }, - "total": { - "type": "integer", - "example": 1 - }, - "link": { - "type": "array", - "items": { - "type": "object", - "required": [ - "relation", - "url" - ], - "properties": { - "relation": { - "type": "string", - "enum": [ - "self" - ], - "example": "self" - }, - "url": { - "type": "string", - "example": "_baseUrl_/FHIR/R4/ServiceRequest?identifier=https://fhir.nhs.uk/Id/UBRN%7C000000070000" - } - } - } - }, - "entry": { - "type": "array", - "description": "| Field | Cardinality | Notes |\n| ---------------------- | ----------- | ------------------------------------------ |\n| `ServiceRequest` | `0..*` | |\n", - "items": { - "title": "ServiceRequest", - "type": "object", - "required": [ - "fullUrl", - "resource", - "search" - ], - "properties": { - "fullUrl": { - "type": "string", - "example": "_baseUrl_/FHIR/R4/ServiceRequest/r.123e4567-e89b-12d3-a456-426614174000" - }, - "resource": { - "title": "eRS-ServiceRequest", - "description": "A record of a request for service such as diagnostic investigations, treatments, or operations to be performed.\nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-ServiceRequest\n", - "type": "object", - "required": [ - "id", - "meta", - "resourceType", - "identifier", - "status", - "intent", - "category", - "subject" - ], - "properties": { - "id": { - "type": "string", - "example": "r.832db7fa-ebdd-44b6-ab3b-8329c2d43149" - }, - "meta": { - "type": "object", - "required": [ - "versionId" - ], - "properties": { - "versionId": { - "type": "string", - "example": "5" - } - } - }, - "resourceType": { - "type": "string", - "enum": [ - "ServiceRequest" - ], - "example": "ServiceRequest" - }, - "identifier": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/UBRN" - ], - "example": "https://fhir.nhs.uk/Id/UBRN" - }, - "value": { - "type": "string", - "example": "000000070000" - } - } - } - }, - "status": { - "type": "string", - "description": "Whilst a potential value to return is `draft`, we are not currently returning this value, but may choose to do so in the future.\n\n| ServiceRequest.status | Description |\n|-----------------------|---------------------------------------------------------------------------------- |\n| active | The `ServiceRequest` is ready to be acted upon. |\n| completed | The `ServiceRequest` has been fully performed and no further activity will occur. |\n| draft | The `ServiceRequest` is incomplete and is not yet ready to be processed. |\n| revoked | The `ServiceRequest` has been terminated and no further activity will occur. |\n", - "enum": [ - "active", - "completed", - "draft", - "revoked" - ], - "example": "active" - }, - "intent": { - "type": "string", - "enum": [ - "order" - ], - "example": "order" - }, - "category": { - "type": "array", - "items": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/message-category-servicerequest" - ] - }, - "code": { - "type": "string", - "enum": [ - "referral", - "request" - ], - "example": "referral" - } - } - } - } - } - } - }, - "code": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/servicerequest-code" - ], - "example": "https://fhir.nhs.uk/CodeSystem/servicerequest-code" - }, - "code": { - "type": "string", - "enum": [ - "advice-and-guidance" - ], - "example": "advice-and-guidance" - } - } - } - } - } - }, - "subject": { - "type": "object", - "required": [ - "identifier" - ], - "properties": { - "identifier": { - "type": "object", - "required": [ - "system", - "value" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/Id/nhs-number" - ], - "example": "https://fhir.nhs.uk/Id/nhs-number" - }, - "value": { - "type": "string", - "example": "9912003888" - } - } - } - } - } - } - }, - "search": { - "type": "object", - "required": [ - "mode" - ], - "properties": { - "mode": { - "type": "string", - "enum": [ - "match" - ], - "example": "match" - } - } - } - } - } - } - } - }, - "examples": { - "minimal-example-empty": { - "summary": "An empty bundle might be returned when the search completes but matches no requests.", - "value": { - "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleEmpty.json" - } - }, - "minimal-example-referral": { - "summary": "A response containing a single Request ID for a `ServiceRequest` of category `referral`.", - "value": { - "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleReferral.json" - } - }, - "minimal-example-advice": { - "summary": "A response containing a single Request ID for a `ServiceRequest` of category `request`.", - "value": { - "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleAdvice.json" - } - }, - "complex-example-referral-and-advice": { - "summary": "A response containing two Request IDs.", - "value": { - "$ref": "../../../examples/searchServiceRequest/responses/ResponseExampleReferralAndAdvice.json" - } - } - } - } - } - }, - "400": { - "description": "Where status code 400 (Bad Request) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. \nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------ |\n| REC_BAD_REQUEST | required | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | Incorrect or missing expected value. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "invalid", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_BAD_REQUEST" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "401": { - "description": "Where status code 401 (Unauthorized) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------------- | ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| ACCESS_DENIED |
  • login
  • forbidden
| [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to either no credentials being provided or the provided credentials no longer being valid. Callers receiving this code should reauthenticate. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "login", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "ACCESS_DENIED" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "403": { - "description": "Where status code 403 (Forbidden) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------- |\n| REC_FORBIDDEN | forbidden | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A call attempts to access or operate upon a resource without proper authorisation. |\n| ACCESS_DENIED | forbidden | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The request could not be authenticated due to insufficient credentials being provided. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "forbidden", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_FORBIDDEN" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "406": { - "description": "Where status code 406 (Not Acceptable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ------------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------- |\n| REC_NOT_ACCEPTABLE | not-supported | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The requested resource does not have a current representation that would be acceptable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "not-supported", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_NOT_ACCEPTABLE" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "429": { - "description": "Where status code 429 (Too Many Requests) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ----------------------------------------------------------------------------- | ---------------------------------- |\n| TOO_MANY_REQUESTS | throttled | [APIM Error Code](https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode) | The rate limit has been reached. |\n\nThe e-Referral service APIs limit the number of transactions you can make per unit of time.\nThis protects our service against excessive use and denial-of-service (DoS) attacks, and is also to encourage you to use our APIs efficiently.\n\nOur standard rate limit for the production environment is 10 requests per second per application.\nIf you go over the rate limit you'll receive a response with an HTTP status of 429 (Too Many Requests).\n\nOur path-to-live environments have very low rate limits.\nThey are for functional testing only - you should not use them for [[HYPERLINK_PERFORMANCE_TESTING]].\n\nIf you have problems with rate limits, [[HYPERLINK_CONTACT_US]] to discuss your application design and volumetrics,\nand to see whether it's appropriate to raise your rate limit.\n\nIf a 429 response is received, indicating a request has been rate limited, then you must back off and retry with exponentially increasing periods between requests.\nOnce a request is successful again, then you may continue to send requests inline with the documented rate limits.\n\nExample:\n - Receive a 429 response\n - Wait 1s and resend, but still receive a 429\n - Wait 2s and resend, but still receive a 429\n - Wait 4s, request is successful\n - Return to normal request cadence\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "throttled", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "code": "TOO_MANY_REQUESTS" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "500": { - "description": "Where status code 500 (Internal Server Error) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nCheck diagnostics property for specific information regarding the error.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |\n| REC_SERVER_ERROR | exception | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | The server encountered an unexpected condition that prevented it from fulfilling the request. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "exception", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_SERVER_ERROR" - } - ] - }, - "diagnostics": "Example diagnostics message." - } - ] - } - } - } - }, - "503": { - "description": "Where status code 503 (Service Unavailable) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below.\nIn response to receiving this status code, it is recommended that clients retry at a later time based on a returned `Retry-After` header when provided.\n\n| issue.details.coding.code | issue.code | Coding System | Description |\n| ------------------------- | ---------- | ------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------ |\n| REC_UNAVAILABLE | transient | [BaRS Error Code](https://fhir.nhs.uk/CodeSystem/http-error-codes) | A request to an internal component timed out whilst attempting to serve a response or the system is currently otherwise unavailable. |\n", - "headers": { - "X-Correlation-ID": { - "description": "The X-Correlation-ID from the request header, if supplied, mirrored back.\n", - "required": false, - "schema": { - "type": "string", - "example": "11C46F5F-CDEF-4865-94B2-0EE0EDCC26DA" - } - }, - "X-Request-ID": { - "description": "The e-RS transaction id\n", - "required": false, - "schema": { - "type": "string", - "example": "58621d65-d5ad-4c3a-959f-0438e355990e-1" - } - }, - "Content-Type": { - "description": "Indicates the media type of the associated resource.\n", - "required": true, - "schema": { - "type": "string", - "enum": [ - "application/fhir+json" - ], - "example": "application/fhir+json" - } - }, - "Retry-After": { - "description": "Defines a period (in seconds) after which the client should attempt their request again.\n", - "required": false, - "schema": { - "type": "string", - "example": "120" - } - } - }, - "content": { - "application/fhir+json": { - "schema": { - "title": "NHSDigital-OperationOutcome", - "description": "Operation outcomes are sets of error, warning and information messages that provide detailed information about the outcome of an attempted system operation. \nThe canonical URL: https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome \n", - "type": "object", - "required": [ - "resourceType", - "meta", - "issue" - ], - "properties": { - "resourceType": { - "type": "string", - "enum": [ - "OperationOutcome" - ], - "example": "OperationOutcome" - }, - "meta": { - "type": "object", - "required": [ - "lastUpdated" - ], - "properties": { - "lastUpdated": { - "type": "string", - "format": "date-time", - "example": "2021-08-04T14:35:00.000Z" - } - } - }, - "issue": { - "type": "array", - "items": { - "type": "object", - "required": [ - "severity", - "code", - "details" - ], - "properties": { - "severity": { - "type": "string", - "enum": [ - "fatal", - "error", - "warning", - "information" - ], - "example": "error" - }, - "code": { - "type": "string", - "example": "required" - }, - "diagnostics": { - "type": "string", - "example": "Incorrect or missing expected value." - }, - "details": { - "type": "object", - "required": [ - "coding" - ], - "properties": { - "coding": { - "type": "array", - "items": { - "type": "object", - "required": [ - "system", - "code" - ], - "properties": { - "system": { - "type": "string", - "enum": [ - "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode", - "https://fhir.nhs.uk/CodeSystem/ers-error-codes" - ], - "example": "https://fhir.nhs.uk/CodeSystem/http-error-codes" - }, - "code": { - "type": "string", - "example": "REC_BAD_REQUEST" - } - } - } - } - } - } - } - } - } - } - }, - "example": { - "resourceType": "OperationOutcome", - "meta": { - "lastUpdated": "2022-03-01T10:00:00.42Z" - }, - "issue": [ - { - "severity": "error", - "code": "transient", - "details": { - "coding": [ - { - "system": "https://fhir.nhs.uk/CodeSystem/http-error-codes", - "code": "REC_UNAVAILABLE" - } - ] - } - } - ] - } - } - } - } - } - } - } - }, - "components": { - "securitySchemes": { - "bearerAuth": { - "type": "http", - "scheme": "bearer", - "bearerFormat": "JWT" - } - }, - "mediaTypes": { - "FileContentTypeSchemaDownload": { - "text/plain": { - "schema": { - "type": "string", - "format": "binary" - }, - "example": "This is some example text." - }, - "text/html": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/xml": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/rtf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/basic": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/png": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/gif": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/jpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/tiff": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "video/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/msword": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/dicom": { - "schema": { - "type": "string", - "format": "binary" - } - } - }, - "FileContentTypeSchemaUpload": { - "text/plain": { - "schema": { - "type": "string", - "format": "binary" - }, - "example": "This is some example text." - }, - "application/pdf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/xml": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "text/rtf": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/basic": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "audio/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/png": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/gif": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/jpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "image/tiff": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "video/mpeg": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/msword": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/vnd.openxmlformats-officedocument.wordprocessingml.document": { - "schema": { - "type": "string", - "format": "binary" - } - }, - "application/dicom": { - "schema": { - "type": "string", - "format": "binary" - } - } - } - } - }, - "x-nhsd-api-platform": { - "meta": { - "service_name": "e-referrals-service-api", - "short_service_name": "ers", - "service_base_path": "referrals", - "product_display_name": "e-Referrals-Service", - "product_description": "The NHS e-RS vision is to enable local innovation and adoption of paperless referrals. To support this vision NHS Digital have created a set of APIs which provide a well-defined, simple to use data interface to the NHS e-Referral Service (e-RS). See https://digital.nhs.uk/developer/api-catalogue/e-referral-service-fhir", - "pipeline_name_prefix": "E-Referrals-Service" - } - } -} \ No newline at end of file From 8d4ab1112ca4b79140f81a0e587191cae9dfec48 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 17 Apr 2026 05:35:47 +0000 Subject: [PATCH 36/55] Bump protobufjs from 7.5.4 to 7.5.5 Bumps [protobufjs](https://github.com/protobufjs/protobuf.js) from 7.5.4 to 7.5.5. - [Release notes](https://github.com/protobufjs/protobuf.js/releases) - [Changelog](https://github.com/protobufjs/protobuf.js/blob/master/CHANGELOG.md) - [Commits](https://github.com/protobufjs/protobuf.js/compare/protobufjs-v7.5.4...protobufjs-v7.5.5) --- updated-dependencies: - dependency-name: protobufjs dependency-version: 7.5.5 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- package-lock.json | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/package-lock.json b/package-lock.json index 236052a33..b6e795346 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1921,11 +1921,10 @@ } }, "node_modules/protobufjs": { - "version": "7.5.4", - "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz", - "integrity": "sha512-CvexbZtbov6jW2eXAvLukXjXUW1TzFaivC46BpWc/3BpcCysb5Vffu+B3XHMm8lVEuy2Mm4XGex8hBSg1yapPg==", + "version": "7.5.5", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.5.tgz", + "integrity": "sha512-3wY1AxV+VBNW8Yypfd1yQY9pXnqTAN+KwQxL8iYm3/BjKYMNg4i0owhEe26PWDOMaIrzeeF98Lqd5NGz4omiIg==", "hasInstallScript": true, - "license": "BSD-3-Clause", "dependencies": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", @@ -4131,9 +4130,9 @@ } }, "protobufjs": { - "version": "7.5.4", - "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.4.tgz", - "integrity": "sha512-CvexbZtbov6jW2eXAvLukXjXUW1TzFaivC46BpWc/3BpcCysb5Vffu+B3XHMm8lVEuy2Mm4XGex8hBSg1yapPg==", + "version": "7.5.5", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.5.tgz", + "integrity": "sha512-3wY1AxV+VBNW8Yypfd1yQY9pXnqTAN+KwQxL8iYm3/BjKYMNg4i0owhEe26PWDOMaIrzeeF98Lqd5NGz4omiIg==", "requires": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", From 8e6d1baec9988438519edd09b231ad7d1286a856 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 8 Apr 2026 22:41:49 +0000 Subject: [PATCH 37/55] Bump cryptography from 46.0.6 to 46.0.7 Bumps [cryptography](https://github.com/pyca/cryptography) from 46.0.6 to 46.0.7. - [Changelog](https://github.com/pyca/cryptography/blob/main/CHANGELOG.rst) - [Commits](https://github.com/pyca/cryptography/compare/46.0.6...46.0.7) --- updated-dependencies: - dependency-name: cryptography dependency-version: 46.0.7 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- poetry.lock | 106 ++++++++++++++++++++++++++-------------------------- 1 file changed, 53 insertions(+), 53 deletions(-) diff --git a/poetry.lock b/poetry.lock index 79b3ee75d..0264789bf 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 2.3.2 and should not be changed by hand. +# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand. [[package]] name = "annotated-types" @@ -369,61 +369,61 @@ markers = {main = "sys_platform == \"win32\"", dev = "sys_platform == \"win32\" [[package]] name = "cryptography" -version = "46.0.6" +version = "46.0.7" description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers." optional = false python-versions = "!=3.9.0,!=3.9.1,>=3.8" groups = ["dev"] files = [ - {file = "cryptography-46.0.6-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:64235194bad039a10bb6d2d930ab3323baaec67e2ce36215fd0952fad0930ca8"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:26031f1e5ca62fcb9d1fcb34b2b60b390d1aacaa15dc8b895a9ed00968b97b30"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9a693028b9cbe51b5a1136232ee8f2bc242e4e19d456ded3fa7c86e43c713b4a"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:67177e8a9f421aa2d3a170c3e56eca4e0128883cf52a071a7cbf53297f18b175"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:d9528b535a6c4f8ff37847144b8986a9a143585f0540fbcb1a98115b543aa463"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:22259338084d6ae497a19bae5d4c66b7ca1387d3264d1c2c0e72d9e9b6a77b97"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:760997a4b950ff00d418398ad73fbc91aa2894b5c1db7ccb45b4f68b42a63b3c"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:3dfa6567f2e9e4c5dceb8ccb5a708158a2a871052fa75c8b78cb0977063f1507"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:cdcd3edcbc5d55757e5f5f3d330dd00007ae463a7e7aa5bf132d1f22a4b62b19"}, - {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:d4e4aadb7fc1f88687f47ca20bb7227981b03afaae69287029da08096853b738"}, - {file = "cryptography-46.0.6-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:2b417edbe8877cda9022dde3a008e2deb50be9c407eef034aeeb3a8b11d9db3c"}, - {file = "cryptography-46.0.6-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:380343e0653b1c9d7e1f55b52aaa2dbb2fdf2730088d48c43ca1c7c0abb7cc2f"}, - {file = "cryptography-46.0.6-cp311-abi3-win32.whl", hash = "sha256:bcb87663e1f7b075e48c3be3ecb5f0b46c8fc50b50a97cf264e7f60242dca3f2"}, - {file = "cryptography-46.0.6-cp311-abi3-win_amd64.whl", hash = "sha256:6739d56300662c468fddb0e5e291f9b4d084bead381667b9e654c7dd81705124"}, - {file = "cryptography-46.0.6-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:2ef9e69886cbb137c2aef9772c2e7138dc581fad4fcbcf13cc181eb5a3ab6275"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7f417f034f91dcec1cb6c5c35b07cdbb2ef262557f701b4ecd803ee8cefed4f4"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d24c13369e856b94892a89ddf70b332e0b70ad4a5c43cf3e9cb71d6d7ffa1f7b"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:aad75154a7ac9039936d50cf431719a2f8d4ed3d3c277ac03f3339ded1a5e707"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:3c21d92ed15e9cfc6eb64c1f5a0326db22ca9c2566ca46d845119b45b4400361"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:4668298aef7cddeaf5c6ecc244c2302a2b8e40f384255505c22875eebb47888b"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:8ce35b77aaf02f3b59c90b2c8a05c73bac12cea5b4e8f3fbece1f5fddea5f0ca"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:c89eb37fae9216985d8734c1afd172ba4927f5a05cfd9bf0e4863c6d5465b013"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:ed418c37d095aeddf5336898a132fba01091f0ac5844e3e8018506f014b6d2c4"}, - {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:69cf0056d6947edc6e6760e5f17afe4bea06b56a9ac8a06de9d2bd6b532d4f3a"}, - {file = "cryptography-46.0.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8e7304c4f4e9490e11efe56af6713983460ee0780f16c63f219984dab3af9d2d"}, - {file = "cryptography-46.0.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b928a3ca837c77a10e81a814a693f2295200adb3352395fad024559b7be7a736"}, - {file = "cryptography-46.0.6-cp314-cp314t-win32.whl", hash = "sha256:97c8115b27e19e592a05c45d0dd89c57f81f841cc9880e353e0d3bf25b2139ed"}, - {file = "cryptography-46.0.6-cp314-cp314t-win_amd64.whl", hash = "sha256:c797e2517cb7880f8297e2c0f43bb910e91381339336f75d2c1c2cbf811b70b4"}, - {file = "cryptography-46.0.6-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:12cae594e9473bca1a7aceb90536060643128bb274fcea0fc459ab90f7d1ae7a"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:639301950939d844a9e1c4464d7e07f902fe9a7f6b215bb0d4f28584729935d8"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ed3775295fb91f70b4027aeba878d79b3e55c0b3e97eaa4de71f8f23a9f2eb77"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:8927ccfbe967c7df312ade694f987e7e9e22b2425976ddbf28271d7e58845290"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:b12c6b1e1651e42ab5de8b1e00dc3b6354fdfd778e7fa60541ddacc27cd21410"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:063b67749f338ca9c5a0b7fe438a52c25f9526b851e24e6c9310e7195aad3b4d"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:02fad249cb0e090b574e30b276a3da6a149e04ee2f049725b1f69e7b8351ec70"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:7e6142674f2a9291463e5e150090b95a8519b2fb6e6aaec8917dd8d094ce750d"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:456b3215172aeefb9284550b162801d62f5f264a081049a3e94307fe20792cfa"}, - {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:341359d6c9e68834e204ceaf25936dffeafea3829ab80e9503860dcc4f4dac58"}, - {file = "cryptography-46.0.6-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9a9c42a2723999a710445bc0d974e345c32adfd8d2fac6d8a251fa829ad31cfb"}, - {file = "cryptography-46.0.6-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:6617f67b1606dfd9fe4dbfa354a9508d4a6d37afe30306fe6c101b7ce3274b72"}, - {file = "cryptography-46.0.6-cp38-abi3-win32.whl", hash = "sha256:7f6690b6c55e9c5332c0b59b9c8a3fb232ebf059094c17f9019a51e9827df91c"}, - {file = "cryptography-46.0.6-cp38-abi3-win_amd64.whl", hash = "sha256:79e865c642cfc5c0b3eb12af83c35c5aeff4fa5c672dc28c43721c2c9fdd2f0f"}, - {file = "cryptography-46.0.6-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:2ea0f37e9a9cf0df2952893ad145fd9627d326a59daec9b0802480fa3bcd2ead"}, - {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:a3e84d5ec9ba01f8fd03802b2147ba77f0c8f2617b2aff254cedd551844209c8"}, - {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:12f0fa16cc247b13c43d56d7b35287ff1569b5b1f4c5e87e92cc4fcc00cd10c0"}, - {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:50575a76e2951fe7dbd1f56d181f8c5ceeeb075e9ff88e7ad997d2f42af06e7b"}, - {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:90e5f0a7b3be5f40c3a0a0eafb32c681d8d2c181fc2a1bdabe9b3f611d9f6b1a"}, - {file = "cryptography-46.0.6-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6728c49e3b2c180ef26f8e9f0a883a2c585638db64cf265b49c9ba10652d430e"}, - {file = "cryptography-46.0.6.tar.gz", hash = "sha256:27550628a518c5c6c903d84f637fbecf287f6cb9ced3804838a1295dc1fd0759"}, + {file = "cryptography-46.0.7-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:ea42cbe97209df307fdc3b155f1b6fa2577c0defa8f1f7d3be7d31d189108ad4"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:b36a4695e29fe69215d75960b22577197aca3f7a25b9cf9d165dcfe9d80bc325"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5ad9ef796328c5e3c4ceed237a183f5d41d21150f972455a9d926593a1dcb308"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:73510b83623e080a2c35c62c15298096e2a5dc8d51c3b4e1740211839d0dea77"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cbd5fb06b62bd0721e1170273d3f4d5a277044c47ca27ee257025146c34cbdd1"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:420b1e4109cc95f0e5700eed79908cef9268265c773d3a66f7af1eef53d409ef"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:24402210aa54baae71d99441d15bb5a1919c195398a87b563df84468160a65de"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:8a469028a86f12eb7d2fe97162d0634026d92a21f3ae0ac87ed1c4a447886c83"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:9694078c5d44c157ef3162e3bf3946510b857df5a3955458381d1c7cfc143ddb"}, + {file = "cryptography-46.0.7-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:42a1e5f98abb6391717978baf9f90dc28a743b7d9be7f0751a6f56a75d14065b"}, + {file = "cryptography-46.0.7-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:91bbcb08347344f810cbe49065914fe048949648f6bd5c2519f34619142bbe85"}, + {file = "cryptography-46.0.7-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:5d1c02a14ceb9148cc7816249f64f623fbfee39e8c03b3650d842ad3f34d637e"}, + {file = "cryptography-46.0.7-cp311-abi3-win32.whl", hash = "sha256:d23c8ca48e44ee015cd0a54aeccdf9f09004eba9fc96f38c911011d9ff1bd457"}, + {file = "cryptography-46.0.7-cp311-abi3-win_amd64.whl", hash = "sha256:397655da831414d165029da9bc483bed2fe0e75dde6a1523ec2fe63f3c46046b"}, + {file = "cryptography-46.0.7-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:d151173275e1728cf7839aaa80c34fe550c04ddb27b34f48c232193df8db5842"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:db0f493b9181c7820c8134437eb8b0b4792085d37dbb24da050476ccb664e59c"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ebd6daf519b9f189f85c479427bbd6e9c9037862cf8fe89ee35503bd209ed902"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:b7b412817be92117ec5ed95f880defe9cf18a832e8cafacf0a22337dc1981b4d"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:fbfd0e5f273877695cb93baf14b185f4878128b250cc9f8e617ea0c025dfb022"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:ffca7aa1d00cf7d6469b988c581598f2259e46215e0140af408966a24cf086ce"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:60627cf07e0d9274338521205899337c5d18249db56865f943cbe753aa96f40f"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:80406c3065e2c55d7f49a9550fe0c49b3f12e5bfff5dedb727e319e1afb9bf99"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:c5b1ccd1239f48b7151a65bc6dd54bcfcc15e028c8ac126d3fada09db0e07ef1"}, + {file = "cryptography-46.0.7-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:d5f7520159cd9c2154eb61eb67548ca05c5774d39e9c2c4339fd793fe7d097b2"}, + {file = "cryptography-46.0.7-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:fcd8eac50d9138c1d7fc53a653ba60a2bee81a505f9f8850b6b2888555a45d0e"}, + {file = "cryptography-46.0.7-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:65814c60f8cc400c63131584e3e1fad01235edba2614b61fbfbfa954082db0ee"}, + {file = "cryptography-46.0.7-cp314-cp314t-win32.whl", hash = "sha256:fdd1736fed309b4300346f88f74cd120c27c56852c3838cab416e7a166f67298"}, + {file = "cryptography-46.0.7-cp314-cp314t-win_amd64.whl", hash = "sha256:e06acf3c99be55aa3b516397fe42f5855597f430add9c17fa46bf2e0fb34c9bb"}, + {file = "cryptography-46.0.7-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:462ad5cb1c148a22b2e3bcc5ad52504dff325d17daf5df8d88c17dda1f75f2a4"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:84d4cced91f0f159a7ddacad249cc077e63195c36aac40b4150e7a57e84fffe7"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:128c5edfe5e5938b86b03941e94fac9ee793a94452ad1365c9fc3f4f62216832"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:5e51be372b26ef4ba3de3c167cd3d1022934bc838ae9eaad7e644986d2a3d163"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:cdf1a610ef82abb396451862739e3fc93b071c844399e15b90726ef7470eeaf2"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1d25aee46d0c6f1a501adcddb2d2fee4b979381346a78558ed13e50aa8a59067"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:cdfbe22376065ffcf8be74dc9a909f032df19bc58a699456a21712d6e5eabfd0"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:abad9dac36cbf55de6eb49badd4016806b3165d396f64925bf2999bcb67837ba"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:935ce7e3cfdb53e3536119a542b839bb94ec1ad081013e9ab9b7cfd478b05006"}, + {file = "cryptography-46.0.7-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:35719dc79d4730d30f1c2b6474bd6acda36ae2dfae1e3c16f2051f215df33ce0"}, + {file = "cryptography-46.0.7-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:7bbc6ccf49d05ac8f7d7b5e2e2c33830d4fe2061def88210a126d130d7f71a85"}, + {file = "cryptography-46.0.7-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a1529d614f44b863a7b480c6d000fe93b59acee9c82ffa027cfadc77521a9f5e"}, + {file = "cryptography-46.0.7-cp38-abi3-win32.whl", hash = "sha256:f247c8c1a1fb45e12586afbb436ef21ff1e80670b2861a90353d9b025583d246"}, + {file = "cryptography-46.0.7-cp38-abi3-win_amd64.whl", hash = "sha256:506c4ff91eff4f82bdac7633318a526b1d1309fc07ca76a3ad182cb5b686d6d3"}, + {file = "cryptography-46.0.7-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:fc9ab8856ae6cf7c9358430e49b368f3108f050031442eaeb6b9d87e4dcf4e4f"}, + {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:d3b99c535a9de0adced13d159c5a9cf65c325601aa30f4be08afd680643e9c15"}, + {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:d02c738dacda7dc2a74d1b2b3177042009d5cab7c7079db74afc19e56ca1b455"}, + {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:04959522f938493042d595a736e7dbdff6eb6cc2339c11465b3ff89343b65f65"}, + {file = "cryptography-46.0.7-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:3986ac1dee6def53797289999eabe84798ad7817f3e97779b5061a95b0ee4968"}, + {file = "cryptography-46.0.7-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:258514877e15963bd43b558917bc9f54cf7cf866c38aa576ebf47a77ddbc43a4"}, + {file = "cryptography-46.0.7.tar.gz", hash = "sha256:e4cfd68c5f3e0bfdad0d38e023239b96a2fe84146481852dffbcca442c245aa5"}, ] [package.dependencies] @@ -436,7 +436,7 @@ nox = ["nox[uv] (>=2024.4.15)"] pep8test = ["check-sdist", "click (>=8.0.1)", "mypy (>=1.14)", "ruff (>=0.11.11)"] sdist = ["build (>=1.0.0)"] ssh = ["bcrypt (>=3.1.5)"] -test = ["certifi (>=2024)", "cryptography-vectors (==46.0.6)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"] +test = ["certifi (>=2024)", "cryptography-vectors (==46.0.7)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"] test-randomorder = ["pytest-randomly"] [[package]] @@ -600,7 +600,7 @@ files = [ [package.dependencies] attrs = ">=22.2.0" -jsonschema-specifications = ">=2023.3.6" +jsonschema-specifications = ">=2023.03.6" referencing = ">=0.28.4" rpds-py = ">=0.25.0" From 1987055743939378f6db7f19a302e72d094ab499 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Fri, 17 Apr 2026 01:25:15 +0000 Subject: [PATCH 38/55] Bump authlib from 1.6.9 to 1.6.11 Bumps [authlib](https://github.com/authlib/authlib) from 1.6.9 to 1.6.11. - [Release notes](https://github.com/authlib/authlib/releases) - [Changelog](https://github.com/authlib/authlib/blob/v1.6.11/docs/changelog.rst) - [Commits](https://github.com/authlib/authlib/compare/v1.6.9...v1.6.11) --- updated-dependencies: - dependency-name: authlib dependency-version: 1.6.11 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- poetry.lock | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/poetry.lock b/poetry.lock index 0264789bf..2f748eac0 100644 --- a/poetry.lock +++ b/poetry.lock @@ -26,14 +26,14 @@ files = [ [[package]] name = "authlib" -version = "1.6.9" +version = "1.6.11" description = "The ultimate Python library in building OAuth and OpenID Connect servers and clients." optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "authlib-1.6.9-py2.py3-none-any.whl", hash = "sha256:f08b4c14e08f0861dc18a32357b33fbcfd2ea86cfe3fe149484b4d764c4a0ac3"}, - {file = "authlib-1.6.9.tar.gz", hash = "sha256:d8f2421e7e5980cc1ddb4e32d3f5fa659cfaf60d8eaf3281ebed192e4ab74f04"}, + {file = "authlib-1.6.11-py2.py3-none-any.whl", hash = "sha256:c8687a9a26451c51a34a06fa17bb97cb15bba46a6a626755e2d7f50da8bff3e3"}, + {file = "authlib-1.6.11.tar.gz", hash = "sha256:64db35b9b01aeccb4715a6c9a6613a06f2bd7be2ab9d2eb89edd1dfc7580a38f"}, ] [package.dependencies] From b948156f65c224e083b50f9be0d8839fb620ce9b Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 27 Apr 2026 00:04:47 +0000 Subject: [PATCH 39/55] npm(deps-dev): bump minimatch from 3.1.4 to 3.1.5 Bumps [minimatch](https://github.com/isaacs/minimatch) from 3.1.4 to 3.1.5. - [Changelog](https://github.com/isaacs/minimatch/blob/main/changelog.md) - [Commits](https://github.com/isaacs/minimatch/compare/v3.1.4...v3.1.5) --- updated-dependencies: - dependency-name: minimatch dependency-version: 3.1.5 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 29 ++++++++++++++--------------- 1 file changed, 14 insertions(+), 15 deletions(-) diff --git a/package-lock.json b/package-lock.json index b6e795346..f441d5e6b 100644 --- a/package-lock.json +++ b/package-lock.json @@ -484,12 +484,11 @@ } }, "node_modules/@redocly/cli/node_modules/minimatch": { - "version": "10.2.4", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz", - "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==", - "license": "BlueOak-1.0.0", + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", "dependencies": { - "brace-expansion": "^5.0.2" + "brace-expansion": "^5.0.5" }, "engines": { "node": "18 || 20 || >=22" @@ -1436,9 +1435,9 @@ } }, "node_modules/minimatch": { - "version": "3.1.4", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.4.tgz", - "integrity": "sha512-twmL+S8+7yIsE9wsqgzU3E8/LumN3M3QELrBZ20OdmQ9jB2JvW5oZtBEmft84k/Gs5CG9mqtWc6Y9vW+JEzGxw==", + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", "dev": true, "dependencies": { "brace-expansion": "^1.1.7" @@ -3132,11 +3131,11 @@ } }, "minimatch": { - "version": "10.2.4", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.4.tgz", - "integrity": "sha512-oRjTw/97aTBN0RHbYCdtF1MQfvusSIBQM0IZEgzl6426+8jSC0nF1a/GmnVLpfB9yyr6g6FTqWqiZVbxrtaCIg==", + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", "requires": { - "brace-expansion": "^5.0.2" + "brace-expansion": "^5.0.5" } }, "semver": { @@ -3824,9 +3823,9 @@ "integrity": "sha512-PRsaiG84bK+AMvxziE/lCFss8juXjNaWzVbN5tXAm4XjeaS9NAHhop+PjQxz2A9h8Q4M/xGmzP8vqNwy6JeK0A==" }, "minimatch": { - "version": "3.1.4", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.4.tgz", - "integrity": "sha512-twmL+S8+7yIsE9wsqgzU3E8/LumN3M3QELrBZ20OdmQ9jB2JvW5oZtBEmft84k/Gs5CG9mqtWc6Y9vW+JEzGxw==", + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", "dev": true, "requires": { "brace-expansion": "^1.1.7" From 0a75d7a1ed6e24034902b50beea20f380070c60a Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 27 Apr 2026 00:04:48 +0000 Subject: [PATCH 40/55] npm(deps): bump fast-xml-parser from 5.5.9 to 5.7.2 Bumps [fast-xml-parser](https://github.com/NaturalIntelligence/fast-xml-parser) from 5.5.9 to 5.7.2. - [Release notes](https://github.com/NaturalIntelligence/fast-xml-parser/releases) - [Changelog](https://github.com/NaturalIntelligence/fast-xml-parser/blob/master/CHANGELOG.md) - [Commits](https://github.com/NaturalIntelligence/fast-xml-parser/compare/v5.5.9...v5.7.2) --- updated-dependencies: - dependency-name: fast-xml-parser dependency-version: 5.5.10 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 84 +++++++++++++++++++++++++++-------------------- 1 file changed, 49 insertions(+), 35 deletions(-) diff --git a/package-lock.json b/package-lock.json index b6e795346..9c21465e8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -106,6 +106,17 @@ "url": "https://paulmillr.com/funding/" } }, + "node_modules/@nodable/entities": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-2.1.0.tgz", + "integrity": "sha512-nyT7T3nbMyBI/lvr6L5TyWbFJAI9FTgVRakNoBqCD+PmID8DzFrrNdLLtHMwMszOtqZa8PAOV24ZqDnQrhQINA==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/nodable" + } + ] + }, "node_modules/@opentelemetry/api": { "version": "1.9.1", "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz", @@ -1069,35 +1080,34 @@ "license": "BSD-3-Clause" }, "node_modules/fast-xml-builder": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz", - "integrity": "sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==", + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.5.tgz", + "integrity": "sha512-4TJn/8FKLeslLAH3dnohXqE3QSoxkhvaMzepOIZytwJXZO69Bfz0HBdDHzOTOon6G59Zrk6VQ2bEiv1t61rfkA==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], - "license": "MIT", "dependencies": { "path-expression-matcher": "^1.1.3" } }, "node_modules/fast-xml-parser": { - "version": "5.5.9", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.9.tgz", - "integrity": "sha512-jldvxr1MC6rtiZKgrFnDSvT8xuH+eJqxqOBThUVjYrxssYTo1avZLGql5l0a0BAERR01CadYzZ83kVEkbyDg+g==", + "version": "5.7.2", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.7.2.tgz", + "integrity": "sha512-P7oW7tLbYnhOLQk/Gv7cZgzgMPP/XN03K02/Jy6Y/NHzyIAIpxuZIM/YqAkfiXFPxA2CTm7NtCijK9EDu09u2w==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], - "license": "MIT", "dependencies": { - "fast-xml-builder": "^1.1.4", - "path-expression-matcher": "^1.2.0", - "strnum": "^2.2.2" + "@nodable/entities": "^2.1.0", + "fast-xml-builder": "^1.1.5", + "path-expression-matcher": "^1.5.0", + "strnum": "^2.2.3" }, "bin": { "fxparser": "src/cli/cli.js" @@ -1776,16 +1786,15 @@ "license": "MIT" }, "node_modules/path-expression-matcher": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz", - "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==", + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz", + "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], - "license": "MIT", "engines": { "node": ">=14.0.0" } @@ -2478,16 +2487,15 @@ } }, "node_modules/strnum": { - "version": "2.2.2", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.2.tgz", - "integrity": "sha512-DnR90I+jtXNSTXWdwrEy9FakW7UX+qUZg28gj5fk2vxxl7uS/3bpI4fjFYVmdK9etptYBPNkpahuQnEwhwECqA==", + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.3.tgz", + "integrity": "sha512-oKx6RUCuHfT3oyVjtnrmn19H1SiCqgJSg+54XqURKp5aCMbrXrhLjRN9TjuwMjiYstZ0MzDrHqkGZ5dFTKd+zg==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } - ], - "license": "MIT" + ] }, "node_modules/styled-components": { "version": "6.3.9", @@ -2892,6 +2900,11 @@ "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz", "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==" }, + "@nodable/entities": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-2.1.0.tgz", + "integrity": "sha512-nyT7T3nbMyBI/lvr6L5TyWbFJAI9FTgVRakNoBqCD+PmID8DzFrrNdLLtHMwMszOtqZa8PAOV24ZqDnQrhQINA==" + }, "@opentelemetry/api": { "version": "1.9.1", "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz", @@ -3564,21 +3577,22 @@ "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==" }, "fast-xml-builder": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.4.tgz", - "integrity": "sha512-f2jhpN4Eccy0/Uz9csxh3Nu6q4ErKxf0XIsasomfOihuSUa3/xw6w8dnOtCDgEItQFJG8KyXPzQXzcODDrrbOg==", + "version": "1.1.5", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.5.tgz", + "integrity": "sha512-4TJn/8FKLeslLAH3dnohXqE3QSoxkhvaMzepOIZytwJXZO69Bfz0HBdDHzOTOon6G59Zrk6VQ2bEiv1t61rfkA==", "requires": { "path-expression-matcher": "^1.1.3" } }, "fast-xml-parser": { - "version": "5.5.9", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.5.9.tgz", - "integrity": "sha512-jldvxr1MC6rtiZKgrFnDSvT8xuH+eJqxqOBThUVjYrxssYTo1avZLGql5l0a0BAERR01CadYzZ83kVEkbyDg+g==", + "version": "5.7.2", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.7.2.tgz", + "integrity": "sha512-P7oW7tLbYnhOLQk/Gv7cZgzgMPP/XN03K02/Jy6Y/NHzyIAIpxuZIM/YqAkfiXFPxA2CTm7NtCijK9EDu09u2w==", "requires": { - "fast-xml-builder": "^1.1.4", - "path-expression-matcher": "^1.2.0", - "strnum": "^2.2.2" + "@nodable/entities": "^2.1.0", + "fast-xml-builder": "^1.1.5", + "path-expression-matcher": "^1.5.0", + "strnum": "^2.2.3" } }, "foreach": { @@ -4046,9 +4060,9 @@ "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==" }, "path-expression-matcher": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz", - "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==" + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz", + "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==" }, "path-is-absolute": { "version": "1.0.1", @@ -4540,9 +4554,9 @@ } }, "strnum": { - "version": "2.2.2", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.2.tgz", - "integrity": "sha512-DnR90I+jtXNSTXWdwrEy9FakW7UX+qUZg28gj5fk2vxxl7uS/3bpI4fjFYVmdK9etptYBPNkpahuQnEwhwECqA==" + "version": "2.2.3", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.3.tgz", + "integrity": "sha512-oKx6RUCuHfT3oyVjtnrmn19H1SiCqgJSg+54XqURKp5aCMbrXrhLjRN9TjuwMjiYstZ0MzDrHqkGZ5dFTKd+zg==" }, "styled-components": { "version": "6.3.9", From e4697094a2656eec739eeb81ef9793a64f528346 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 27 Apr 2026 00:04:49 +0000 Subject: [PATCH 41/55] npm(deps): bump path-expression-matcher from 1.2.0 to 1.5.0 Bumps [path-expression-matcher](https://github.com/NaturalIntelligence/path-expression-matcher) from 1.2.0 to 1.5.0. - [Commits](https://github.com/NaturalIntelligence/path-expression-matcher/commits) --- updated-dependencies: - dependency-name: path-expression-matcher dependency-version: 1.2.1 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/package-lock.json b/package-lock.json index b6e795346..7eda1b0eb 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1776,16 +1776,15 @@ "license": "MIT" }, "node_modules/path-expression-matcher": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz", - "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==", + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz", + "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], - "license": "MIT", "engines": { "node": ">=14.0.0" } @@ -4046,9 +4045,9 @@ "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==" }, "path-expression-matcher": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.2.0.tgz", - "integrity": "sha512-DwmPWeFn+tq7TiyJ2CxezCAirXjFxvaiD03npak3cRjlP9+OjTmSy1EpIrEbh+l6JgUundniloMLDQ/6VTdhLQ==" + "version": "1.5.0", + "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz", + "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==" }, "path-is-absolute": { "version": "1.0.1", From d2d481c4e7ddecbe8d2d2a0745c41d31bd1168a2 Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Mon, 27 Apr 2026 00:04:54 +0000 Subject: [PATCH 42/55] npm(deps-dev): bump brace-expansion from 1.1.12 to 1.1.14 Bumps [brace-expansion](https://github.com/juliangruber/brace-expansion) from 1.1.12 to 1.1.14. - [Release notes](https://github.com/juliangruber/brace-expansion/releases) - [Commits](https://github.com/juliangruber/brace-expansion/compare/v1.1.12...v1.1.14) --- updated-dependencies: - dependency-name: brace-expansion dependency-version: 1.1.13 dependency-type: indirect update-type: version-update:semver-patch ... Signed-off-by: dependabot[bot] --- package-lock.json | 26 ++++++++++++-------------- 1 file changed, 12 insertions(+), 14 deletions(-) diff --git a/package-lock.json b/package-lock.json index b6e795346..033b926c8 100644 --- a/package-lock.json +++ b/package-lock.json @@ -796,11 +796,10 @@ } }, "node_modules/brace-expansion": { - "version": "1.1.12", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", - "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", "dev": true, - "license": "MIT", "dependencies": { "balanced-match": "^1.0.0", "concat-map": "0.0.1" @@ -2150,10 +2149,9 @@ } }, "node_modules/redoc/node_modules/brace-expansion": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", - "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", - "license": "MIT", + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.0.tgz", + "integrity": "sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==", "dependencies": { "balanced-match": "^1.0.0" } @@ -3368,9 +3366,9 @@ } }, "brace-expansion": { - "version": "1.1.12", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.12.tgz", - "integrity": "sha512-9T9UjW3r0UW5c1Q7GTwllptXwhvYmEzFhzMfZ9H7FQWt+uZePjZPjBP/W1ZEyZ1twGWom5/56TF4lPcqjnDHcg==", + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", "dev": true, "requires": { "balanced-match": "^1.0.0", @@ -4298,9 +4296,9 @@ } }, "brace-expansion": { - "version": "2.0.3", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.0.3.tgz", - "integrity": "sha512-MCV/fYJEbqx68aE58kv2cA/kiky1G8vux3OR6/jbS+jIMe/6fJWa0DTzJU7dqijOWYwHi1t29FlfYI9uytqlpA==", + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.0.tgz", + "integrity": "sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==", "requires": { "balanced-match": "^1.0.0" } From e491b6872adc01ff74af0766034bd2be5acdbb25 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 13 May 2026 10:16:26 +0100 Subject: [PATCH 43/55] Updated poetry lock to fix conflict --- poetry.lock | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/poetry.lock b/poetry.lock index fef19a106..b2ae9e6be 100644 --- a/poetry.lock +++ b/poetry.lock @@ -1,4 +1,4 @@ -# This file is automatically @generated by Poetry 2.2.1 and should not be changed by hand. +# This file is automatically @generated by Poetry 2.3.3 and should not be changed by hand. [[package]] name = "annotated-types" @@ -473,6 +473,7 @@ description = "Backport of PEP 654 (exception groups)" optional = false python-versions = ">=3.7" groups = ["main", "dev"] +markers = "python_version == \"3.10\"" files = [ {file = "exceptiongroup-1.3.1-py3-none-any.whl", hash = "sha256:a7a39a3bd276781e98394987d3a5701d0c4edffb633bb7a5144577f82c773598"}, {file = "exceptiongroup-1.3.1.tar.gz", hash = "sha256:8b412432c6055b0b7d14c310000ae93352ed6754f70fa8f7c34141f91c4e3219"}, @@ -622,7 +623,7 @@ files = [ [package.dependencies] attrs = ">=22.2.0" -jsonschema-specifications = ">=2023.03.6" +jsonschema-specifications = ">=2023.3.6" referencing = ">=0.28.4" rpds-py = ">=0.7.1" From 8e30c51cfa0ade9540f9e10c351af8ff674db922 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 13 May 2026 10:19:44 +0100 Subject: [PATCH 44/55] Updated poetry lock to fix conflict --- poetry.lock | 710 ++++++++++++++++++++++++++++------------------------ 1 file changed, 386 insertions(+), 324 deletions(-) diff --git a/poetry.lock b/poetry.lock index b2ae9e6be..efb7890da 100644 --- a/poetry.lock +++ b/poetry.lock @@ -14,26 +14,26 @@ files = [ [[package]] name = "attrs" -version = "25.4.0" +version = "26.1.0" description = "Classes Without Boilerplate" optional = false python-versions = ">=3.9" groups = ["main"] files = [ - {file = "attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373"}, - {file = "attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11"}, + {file = "attrs-26.1.0-py3-none-any.whl", hash = "sha256:c647aa4a12dfbad9333ca4e71fe62ddc36f4e63b2d260a37a8b83d2f043ac309"}, + {file = "attrs-26.1.0.tar.gz", hash = "sha256:d03ceb89cb322a8fd706d4fb91940737b6642aa36998fe130a9bc96c985eff32"}, ] [[package]] name = "authlib" -version = "1.6.5" +version = "1.6.9" description = "The ultimate Python library in building OAuth and OpenID Connect servers and clients." optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "authlib-1.6.5-py2.py3-none-any.whl", hash = "sha256:3e0e0507807f842b02175507bdee8957a1d5707fd4afb17c32fb43fee90b6e3a"}, - {file = "authlib-1.6.5.tar.gz", hash = "sha256:6aaf9c79b7cc96c900f0b284061691c5d4e61221640a948fe690b556a6d6d10b"}, + {file = "authlib-1.6.9-py2.py3-none-any.whl", hash = "sha256:f08b4c14e08f0861dc18a32357b33fbcfd2ea86cfe3fe149484b4d764c4a0ac3"}, + {file = "authlib-1.6.9.tar.gz", hash = "sha256:d8f2421e7e5980cc1ddb4e32d3f5fa659cfaf60d8eaf3281ebed192e4ab74f04"}, ] [package.dependencies] @@ -54,38 +54,39 @@ files = [ [[package]] name = "black" -version = "25.11.0" +version = "25.12.0" description = "The uncompromising code formatter." optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "black-25.11.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:ec311e22458eec32a807f029b2646f661e6859c3f61bc6d9ffb67958779f392e"}, - {file = "black-25.11.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:1032639c90208c15711334d681de2e24821af0575573db2810b0763bcd62e0f0"}, - {file = "black-25.11.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0c0f7c461df55cf32929b002335883946a4893d759f2df343389c4396f3b6b37"}, - {file = "black-25.11.0-cp310-cp310-win_amd64.whl", hash = "sha256:f9786c24d8e9bd5f20dc7a7f0cdd742644656987f6ea6947629306f937726c03"}, - {file = "black-25.11.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:895571922a35434a9d8ca67ef926da6bc9ad464522a5fe0db99b394ef1c0675a"}, - {file = "black-25.11.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:cb4f4b65d717062191bdec8e4a442539a8ea065e6af1c4f4d36f0cdb5f71e170"}, - {file = "black-25.11.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d81a44cbc7e4f73a9d6ae449ec2317ad81512d1e7dce7d57f6333fd6259737bc"}, - {file = "black-25.11.0-cp311-cp311-win_amd64.whl", hash = "sha256:7eebd4744dfe92ef1ee349dc532defbf012a88b087bb7ddd688ff59a447b080e"}, - {file = "black-25.11.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:80e7486ad3535636657aa180ad32a7d67d7c273a80e12f1b4bfa0823d54e8fac"}, - {file = "black-25.11.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:6cced12b747c4c76bc09b4db057c319d8545307266f41aaee665540bc0e04e96"}, - {file = "black-25.11.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6cb2d54a39e0ef021d6c5eef442e10fd71fcb491be6413d083a320ee768329dd"}, - {file = "black-25.11.0-cp312-cp312-win_amd64.whl", hash = "sha256:ae263af2f496940438e5be1a0c1020e13b09154f3af4df0835ea7f9fe7bfa409"}, - {file = "black-25.11.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:0a1d40348b6621cc20d3d7530a5b8d67e9714906dfd7346338249ad9c6cedf2b"}, - {file = "black-25.11.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:51c65d7d60bb25429ea2bf0731c32b2a2442eb4bd3b2afcb47830f0b13e58bfd"}, - {file = "black-25.11.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:936c4dd07669269f40b497440159a221ee435e3fddcf668e0c05244a9be71993"}, - {file = "black-25.11.0-cp313-cp313-win_amd64.whl", hash = "sha256:f42c0ea7f59994490f4dccd64e6b2dd49ac57c7c84f38b8faab50f8759db245c"}, - {file = "black-25.11.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:35690a383f22dd3e468c85dc4b915217f87667ad9cce781d7b42678ce63c4170"}, - {file = "black-25.11.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:dae49ef7369c6caa1a1833fd5efb7c3024bb7e4499bf64833f65ad27791b1545"}, - {file = "black-25.11.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5bd4a22a0b37401c8e492e994bce79e614f91b14d9ea911f44f36e262195fdda"}, - {file = "black-25.11.0-cp314-cp314-win_amd64.whl", hash = "sha256:aa211411e94fdf86519996b7f5f05e71ba34835d8f0c0f03c00a26271da02664"}, - {file = "black-25.11.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:a3bb5ce32daa9ff0605d73b6f19da0b0e6c1f8f2d75594db539fdfed722f2b06"}, - {file = "black-25.11.0-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:9815ccee1e55717fe9a4b924cae1646ef7f54e0f990da39a34fc7b264fcf80a2"}, - {file = "black-25.11.0-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:92285c37b93a1698dcbc34581867b480f1ba3a7b92acf1fe0467b04d7a4da0dc"}, - {file = "black-25.11.0-cp39-cp39-win_amd64.whl", hash = "sha256:43945853a31099c7c0ff8dface53b4de56c41294fa6783c0441a8b1d9bf668bc"}, - {file = "black-25.11.0-py3-none-any.whl", hash = "sha256:e3f562da087791e96cefcd9dda058380a442ab322a02e222add53736451f604b"}, - {file = "black-25.11.0.tar.gz", hash = "sha256:9a323ac32f5dc75ce7470501b887250be5005a01602e931a15e45593f70f6e08"}, + {file = "black-25.12.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f85ba1ad15d446756b4ab5f3044731bf68b777f8f9ac9cdabd2425b97cd9c4e8"}, + {file = "black-25.12.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:546eecfe9a3a6b46f9d69d8a642585a6eaf348bcbbc4d87a19635570e02d9f4a"}, + {file = "black-25.12.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:17dcc893da8d73d8f74a596f64b7c98ef5239c2cd2b053c0f25912c4494bf9ea"}, + {file = "black-25.12.0-cp310-cp310-win_amd64.whl", hash = "sha256:09524b0e6af8ba7a3ffabdfc7a9922fb9adef60fed008c7cd2fc01f3048e6e6f"}, + {file = "black-25.12.0-cp310-cp310-win_arm64.whl", hash = "sha256:b162653ed89eb942758efeb29d5e333ca5bb90e5130216f8369857db5955a7da"}, + {file = "black-25.12.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:d0cfa263e85caea2cff57d8f917f9f51adae8e20b610e2b23de35b5b11ce691a"}, + {file = "black-25.12.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:1a2f578ae20c19c50a382286ba78bfbeafdf788579b053d8e4980afb079ab9be"}, + {file = "black-25.12.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d3e1b65634b0e471d07ff86ec338819e2ef860689859ef4501ab7ac290431f9b"}, + {file = "black-25.12.0-cp311-cp311-win_amd64.whl", hash = "sha256:a3fa71e3b8dd9f7c6ac4d818345237dfb4175ed3bf37cd5a581dbc4c034f1ec5"}, + {file = "black-25.12.0-cp311-cp311-win_arm64.whl", hash = "sha256:51e267458f7e650afed8445dc7edb3187143003d52a1b710c7321aef22aa9655"}, + {file = "black-25.12.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:31f96b7c98c1ddaeb07dc0f56c652e25bdedaac76d5b68a059d998b57c55594a"}, + {file = "black-25.12.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:05dd459a19e218078a1f98178c13f861fe6a9a5f88fc969ca4d9b49eb1809783"}, + {file = "black-25.12.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c1f68c5eff61f226934be6b5b80296cf6939e5d2f0c2f7d543ea08b204bfaf59"}, + {file = "black-25.12.0-cp312-cp312-win_amd64.whl", hash = "sha256:274f940c147ddab4442d316b27f9e332ca586d39c85ecf59ebdea82cc9ee8892"}, + {file = "black-25.12.0-cp312-cp312-win_arm64.whl", hash = "sha256:169506ba91ef21e2e0591563deda7f00030cb466e747c4b09cb0a9dae5db2f43"}, + {file = "black-25.12.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:a05ddeb656534c3e27a05a29196c962877c83fa5503db89e68857d1161ad08a5"}, + {file = "black-25.12.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:9ec77439ef3e34896995503865a85732c94396edcc739f302c5673a2315e1e7f"}, + {file = "black-25.12.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e509c858adf63aa61d908061b52e580c40eae0dfa72415fa47ac01b12e29baf"}, + {file = "black-25.12.0-cp313-cp313-win_amd64.whl", hash = "sha256:252678f07f5bac4ff0d0e9b261fbb029fa530cfa206d0a636a34ab445ef8ca9d"}, + {file = "black-25.12.0-cp313-cp313-win_arm64.whl", hash = "sha256:bc5b1c09fe3c931ddd20ee548511c64ebf964ada7e6f0763d443947fd1c603ce"}, + {file = "black-25.12.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:0a0953b134f9335c2434864a643c842c44fba562155c738a2a37a4d61f00cad5"}, + {file = "black-25.12.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:2355bbb6c3b76062870942d8cc450d4f8ac71f9c93c40122762c8784df49543f"}, + {file = "black-25.12.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9678bd991cc793e81d19aeeae57966ee02909877cb65838ccffef24c3ebac08f"}, + {file = "black-25.12.0-cp314-cp314-win_amd64.whl", hash = "sha256:97596189949a8aad13ad12fcbb4ae89330039b96ad6742e6f6b45e75ad5cfd83"}, + {file = "black-25.12.0-cp314-cp314-win_arm64.whl", hash = "sha256:778285d9ea197f34704e3791ea9404cd6d07595745907dd2ce3da7a13627b29b"}, + {file = "black-25.12.0-py3-none-any.whl", hash = "sha256:48ceb36c16dbc84062740049eef990bb2ce07598272e673c17d1a7720c71c828"}, + {file = "black-25.12.0.tar.gz", hash = "sha256:8d3dd9cea14bff7ddc0eb243c811cdb1a011ebb4800a5f0335a01a68654796a7"}, ] [package.dependencies] @@ -106,14 +107,14 @@ uvloop = ["uvloop (>=0.15.2)"] [[package]] name = "certifi" -version = "2025.11.12" +version = "2026.2.25" description = "Python package for providing Mozilla's CA Bundle." optional = false python-versions = ">=3.7" groups = ["main", "dev"] files = [ - {file = "certifi-2025.11.12-py3-none-any.whl", hash = "sha256:97de8790030bbd5c2d96b7ec782fc2f7820ef8dba6db909ccf95449f2d062d4b"}, - {file = "certifi-2025.11.12.tar.gz", hash = "sha256:d8ab5478f2ecd78af242878415affce761ca6bc54a22a27e026d7c25357c3316"}, + {file = "certifi-2026.2.25-py3-none-any.whl", hash = "sha256:027692e4402ad994f1c42e52a4997a9763c646b73e4096e4d5d6db8af1d6f0fa"}, + {file = "certifi-2026.2.25.tar.gz", hash = "sha256:e887ab5cee78ea814d3472169153c2d12cd43b14bd03329a39a9c6e2e80bfba7"}, ] [[package]] @@ -216,125 +217,141 @@ pycparser = {version = "*", markers = "implementation_name != \"PyPy\""} [[package]] name = "charset-normalizer" -version = "3.4.4" +version = "3.4.6" description = "The Real First Universal Charset Detector. Open, modern and actively maintained alternative to Chardet." optional = false python-versions = ">=3.7" groups = ["main", "dev"] files = [ - {file = "charset_normalizer-3.4.4-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e824f1492727fa856dd6eda4f7cee25f8518a12f3c4a56a74e8095695089cf6d"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4bd5d4137d500351a30687c2d3971758aac9a19208fc110ccb9d7188fbe709e8"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:027f6de494925c0ab2a55eab46ae5129951638a49a34d87f4c3eda90f696b4ad"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f820802628d2694cb7e56db99213f930856014862f3fd943d290ea8438d07ca8"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:798d75d81754988d2565bff1b97ba5a44411867c0cf32b77a7e8f8d84796b10d"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d1bb833febdff5c8927f922386db610b49db6e0d4f4ee29601d71e7c2694313"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9cd98cdc06614a2f768d2b7286d66805f94c48cde050acdbbb7db2600ab3197e"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:077fbb858e903c73f6c9db43374fd213b0b6a778106bc7032446a8e8b5b38b93"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:244bfb999c71b35de57821b8ea746b24e863398194a4014e4c76adc2bbdfeff0"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:64b55f9dce520635f018f907ff1b0df1fdc31f2795a922fb49dd14fbcdf48c84"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:faa3a41b2b66b6e50f84ae4a68c64fcd0c44355741c6374813a800cd6695db9e"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:6515f3182dbe4ea06ced2d9e8666d97b46ef4c75e326b79bb624110f122551db"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:cc00f04ed596e9dc0da42ed17ac5e596c6ccba999ba6bd92b0e0aef2f170f2d6"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-win32.whl", hash = "sha256:f34be2938726fc13801220747472850852fe6b1ea75869a048d6f896838c896f"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-win_amd64.whl", hash = "sha256:a61900df84c667873b292c3de315a786dd8dac506704dea57bc957bd31e22c7d"}, - {file = "charset_normalizer-3.4.4-cp310-cp310-win_arm64.whl", hash = "sha256:cead0978fc57397645f12578bfd2d5ea9138ea0fac82b2f63f7f7c6877986a69"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:6e1fcf0720908f200cd21aa4e6750a48ff6ce4afe7ff5a79a90d5ed8a08296f8"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5f819d5fe9234f9f82d75bdfa9aef3a3d72c4d24a6e57aeaebba32a704553aa0"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:a59cb51917aa591b1c4e6a43c132f0cdc3c76dbad6155df4e28ee626cc77a0a3"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:8ef3c867360f88ac904fd3f5e1f902f13307af9052646963ee08ff4f131adafc"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d9e45d7faa48ee908174d8fe84854479ef838fc6a705c9315372eacbc2f02897"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:840c25fb618a231545cbab0564a799f101b63b9901f2569faecd6b222ac72381"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ca5862d5b3928c4940729dacc329aa9102900382fea192fc5e52eb69d6093815"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:d9c7f57c3d666a53421049053eaacdd14bbd0a528e2186fcb2e672effd053bb0"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:277e970e750505ed74c832b4bf75dac7476262ee2a013f5574dd49075879e161"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:31fd66405eaf47bb62e8cd575dc621c56c668f27d46a61d975a249930dd5e2a4"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:0d3d8f15c07f86e9ff82319b3d9ef6f4bf907608f53fe9d92b28ea9ae3d1fd89"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:9f7fcd74d410a36883701fafa2482a6af2ff5ba96b9a620e9e0721e28ead5569"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ebf3e58c7ec8a8bed6d66a75d7fb37b55e5015b03ceae72a8e7c74495551e224"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-win32.whl", hash = "sha256:eecbc200c7fd5ddb9a7f16c7decb07b566c29fa2161a16cf67b8d068bd21690a"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-win_amd64.whl", hash = "sha256:5ae497466c7901d54b639cf42d5b8c1b6a4fead55215500d2f486d34db48d016"}, - {file = "charset_normalizer-3.4.4-cp311-cp311-win_arm64.whl", hash = "sha256:65e2befcd84bc6f37095f5961e68a6f077bf44946771354a28ad434c2cce0ae1"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525"}, - {file = "charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14"}, - {file = "charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c"}, - {file = "charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:ce8a0633f41a967713a59c4139d29110c07e826d131a316b50ce11b1d79b4f84"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaabd426fe94daf8fd157c32e571c85cb12e66692f15516a83a03264b08d06c3"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c4ef880e27901b6cc782f1b95f82da9313c0eb95c3af699103088fa0ac3ce9ac"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:2aaba3b0819274cc41757a1da876f810a3e4d7b6eb25699253a4effef9e8e4af"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:778d2e08eda00f4256d7f672ca9fef386071c9202f5e4607920b86d7803387f2"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f155a433c2ec037d4e8df17d18922c3a0d9b3232a396690f17175d2946f0218d"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a8bf8d0f749c5757af2142fe7903a9df1d2e8aa3841559b2bad34b08d0e2bcf3"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:194f08cbb32dc406d6e1aea671a68be0823673db2832b38405deba2fb0d88f63"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:6aee717dcfead04c6eb1ce3bd29ac1e22663cdea57f943c87d1eab9a025438d7"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:cd4b7ca9984e5e7985c12bc60a6f173f3c958eae74f3ef6624bb6b26e2abbae4"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:b7cf1017d601aa35e6bb650b6ad28652c9cd78ee6caff19f3c28d03e1c80acbf"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:e912091979546adf63357d7e2ccff9b44f026c075aeaf25a52d0e95ad2281074"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:5cb4d72eea50c8868f5288b7f7f33ed276118325c1dfd3957089f6b519e1382a"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-win32.whl", hash = "sha256:837c2ce8c5a65a2035be9b3569c684358dfbf109fd3b6969630a87535495ceaa"}, - {file = "charset_normalizer-3.4.4-cp38-cp38-win_amd64.whl", hash = "sha256:44c2a8734b333e0578090c4cd6b16f275e07aa6614ca8715e6c038e865e70576"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:a9768c477b9d7bd54bc0c86dbaebdec6f03306675526c9927c0e8a04e8f94af9"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1bee1e43c28aa63cb16e5c14e582580546b08e535299b8b6158a7c9c768a1f3d"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:fd44c878ea55ba351104cb93cc85e74916eb8fa440ca7903e57575e97394f608"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:0f04b14ffe5fdc8c4933862d8306109a2c51e0704acfa35d51598eb45a1e89fc"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:cd09d08005f958f370f539f186d10aec3377d55b9eeb0d796025d4886119d76e"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4fe7859a4e3e8457458e2ff592f15ccb02f3da787fcd31e0183879c3ad4692a1"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fa09f53c465e532f4d3db095e0c55b615f010ad81803d383195b6b5ca6cbf5f3"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:7fa17817dc5625de8a027cb8b26d9fefa3ea28c8253929b8d6649e705d2835b6"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:5947809c8a2417be3267efc979c47d76a079758166f7d43ef5ae8e9f92751f88"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:4902828217069c3c5c71094537a8e623f5d097858ac6ca8252f7b4d10b7560f1"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:7c308f7e26e4363d79df40ca5b2be1c6ba9f02bdbccfed5abddb7859a6ce72cf"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:2c9d3c380143a1fedbff95a312aa798578371eb29da42106a29019368a475318"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:cb01158d8b88ee68f15949894ccc6712278243d95f344770fa7593fa2d94410c"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-win32.whl", hash = "sha256:2677acec1a2f8ef614c6888b5b4ae4060cc184174a938ed4e8ef690e15d3e505"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-win_amd64.whl", hash = "sha256:f8e160feb2aed042cd657a72acc0b481212ed28b1b9a95c0cee1621b524e1966"}, - {file = "charset_normalizer-3.4.4-cp39-cp39-win_arm64.whl", hash = "sha256:b5d84d37db046c5ca74ee7bb47dd6cbc13f80665fdde3e8040bdd3fb015ecb50"}, - {file = "charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f"}, - {file = "charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:2e1d8ca8611099001949d1cdfaefc510cf0f212484fe7c565f735b68c78c3c95"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e25369dc110d58ddf29b949377a93e0716d72a24f62bad72b2b39f155949c1fd"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:259695e2ccc253feb2a016303543d691825e920917e31f894ca1a687982b1de4"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:dda86aba335c902b6149a02a55b38e96287157e609200811837678214ba2b1db"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:51fb3c322c81d20567019778cb5a4a6f2dc1c200b886bc0d636238e364848c89"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:4482481cb0572180b6fd976a4d5c72a30263e98564da68b86ec91f0fe35e8565"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:39f5068d35621da2881271e5c3205125cc456f54e9030d3f723288c873a71bf9"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:8bea55c4eef25b0b19a0337dc4e3f9a15b00d569c77211fa8cde38684f234fb7"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:f0cdaecd4c953bfae0b6bb64910aaaca5a424ad9c72d85cb88417bb9814f7550"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:150b8ce8e830eb7ccb029ec9ca36022f756986aaaa7956aad6d9ec90089338c0"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:e68c14b04827dd76dcbd1aeea9e604e3e4b78322d8faf2f8132c7138efa340a8"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:3778fd7d7cd04ae8f54651f4a7a0bd6e39a0cf20f801720a4c21d80e9b7ad6b0"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:dad6e0f2e481fffdcf776d10ebee25e0ef89f16d691f1e5dee4b586375fdc64b"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-win32.whl", hash = "sha256:74a2e659c7ecbc73562e2a15e05039f1e22c75b7c7618b4b574a3ea9118d1557"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-win_amd64.whl", hash = "sha256:aa9cccf4a44b9b62d8ba8b4dd06c649ba683e4bf04eea606d2e94cfc2d6ff4d6"}, + {file = "charset_normalizer-3.4.6-cp310-cp310-win_arm64.whl", hash = "sha256:e985a16ff513596f217cee86c21371b8cd011c0f6f056d0920aa2d926c544058"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:82060f995ab5003a2d6e0f4ad29065b7672b6593c8c63559beefe5b443242c3e"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:60c74963d8350241a79cb8feea80e54d518f72c26db618862a8f53e5023deaf9"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6e4333fb15c83f7d1482a76d45a0818897b3d33f00efd215528ff7c51b8e35d"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bc72863f4d9aba2e8fd9085e63548a324ba706d2ea2c83b260da08a59b9482de"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9cc4fc6c196d6a8b76629a70ddfcd4635a6898756e2d9cac5565cf0654605d73"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:0c173ce3a681f309f31b87125fecec7a5d1347261ea11ebbb856fa6006b23c8c"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c907cdc8109f6c619e6254212e794d6548373cc40e1ec75e6e3823d9135d29cc"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:404a1e552cf5b675a87f0651f8b79f5f1e6fd100ee88dc612f89aa16abd4486f"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:e3c701e954abf6fc03a49f7c579cc80c2c6cc52525340ca3186c41d3f33482ef"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:7a6967aaf043bceabab5412ed6bd6bd26603dae84d5cb75bf8d9a74a4959d398"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5feb91325bbceade6afab43eb3b508c63ee53579fe896c77137ded51c6b6958e"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:f820f24b09e3e779fe84c3c456cb4108a7aa639b0d1f02c28046e11bfcd088ed"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:b35b200d6a71b9839a46b9b7fff66b6638bb52fc9658aa58796b0326595d3021"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-win32.whl", hash = "sha256:9ca4c0b502ab399ef89248a2c84c54954f77a070f28e546a85e91da627d1301e"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-win_amd64.whl", hash = "sha256:a9e68c9d88823b274cf1e72f28cb5dc89c990edf430b0bfd3e2fb0785bfeabf4"}, + {file = "charset_normalizer-3.4.6-cp311-cp311-win_arm64.whl", hash = "sha256:97d0235baafca5f2b09cf332cc275f021e694e8362c6bb9c96fc9a0eb74fc316"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:2ef7fedc7a6ecbe99969cd09632516738a97eeb8bd7258bf8a0f23114c057dab"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a4ea868bc28109052790eb2b52a9ab33f3aa7adc02f96673526ff47419490e21"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:836ab36280f21fc1a03c99cd05c6b7af70d2697e374c7af0b61ed271401a72a2"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f1ce721c8a7dfec21fcbdfe04e8f68174183cf4e8188e0645e92aa23985c57ff"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0e28d62a8fc7a1fa411c43bd65e346f3bce9716dc51b897fbe930c5987b402d5"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:530d548084c4a9f7a16ed4a294d459b4f229db50df689bfe92027452452943a0"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:30f445ae60aad5e1f8bdbb3108e39f6fbc09f4ea16c815c66578878325f8f15a"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:ac2393c73378fea4e52aa56285a3d64be50f1a12395afef9cce47772f60334c2"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:90ca27cd8da8118b18a52d5f547859cc1f8354a00cd1e8e5120df3e30d6279e5"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:8e5a94886bedca0f9b78fecd6afb6629142fd2605aa70a125d49f4edc6037ee6"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:695f5c2823691a25f17bc5d5ffe79fa90972cc34b002ac6c843bb8a1720e950d"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:231d4da14bcd9301310faf492051bee27df11f2bc7549bc0bb41fef11b82daa2"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a056d1ad2633548ca18ffa2f85c202cfb48b68615129143915b8dc72a806a923"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-win32.whl", hash = "sha256:c2274ca724536f173122f36c98ce188fd24ce3dad886ec2b7af859518ce008a4"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-win_amd64.whl", hash = "sha256:c8ae56368f8cc97c7e40a7ee18e1cedaf8e780cd8bc5ed5ac8b81f238614facb"}, + {file = "charset_normalizer-3.4.6-cp312-cp312-win_arm64.whl", hash = "sha256:899d28f422116b08be5118ef350c292b36fc15ec2daeb9ea987c89281c7bb5c4"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:11afb56037cbc4b1555a34dd69151e8e069bee82e613a73bef6e714ce733585f"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:423fb7e748a08f854a08a222b983f4df1912b1daedce51a72bd24fe8f26a1843"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:d73beaac5e90173ac3deb9928a74763a6d230f494e4bfb422c217a0ad8e629bf"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d60377dce4511655582e300dc1e5a5f24ba0cb229005a1d5c8d0cb72bb758ab8"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:530e8cebeea0d76bdcf93357aa5e41336f48c3dc709ac52da2bb167c5b8271d9"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:a26611d9987b230566f24a0a125f17fe0de6a6aff9f25c9f564aaa2721a5fb88"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:34315ff4fc374b285ad7f4a0bf7dcbfe769e1b104230d40f49f700d4ab6bbd84"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:5f8ddd609f9e1af8c7bd6e2aca279c931aefecd148a14402d4e368f3171769fd"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:80d0a5615143c0b3225e5e3ef22c8d5d51f3f72ce0ea6fb84c943546c7b25b6c"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:92734d4d8d187a354a556626c221cd1a892a4e0802ccb2af432a1d85ec012194"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:613f19aa6e082cf96e17e3ffd89383343d0d589abda756b7764cf78361fd41dc"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:2b1a63e8224e401cafe7739f77efd3f9e7f5f2026bda4aead8e59afab537784f"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6cceb5473417d28edd20c6c984ab6fee6c6267d38d906823ebfe20b03d607dc2"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-win32.whl", hash = "sha256:d7de2637729c67d67cf87614b566626057e95c303bc0a55ffe391f5205e7003d"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-win_amd64.whl", hash = "sha256:572d7c822caf521f0525ba1bce1a622a0b85cf47ffbdae6c9c19e3b5ac3c4389"}, + {file = "charset_normalizer-3.4.6-cp313-cp313-win_arm64.whl", hash = "sha256:a4474d924a47185a06411e0064b803c68be044be2d60e50e8bddcc2649957c1f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:9cc6e6d9e571d2f863fa77700701dae73ed5f78881efc8b3f9a4398772ff53e8"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ef5960d965e67165d75b7c7ffc60a83ec5abfc5c11b764ec13ea54fbef8b4421"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:b3694e3f87f8ac7ce279d4355645b3c878d24d1424581b46282f24b92f5a4ae2"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5d11595abf8dd942a77883a39d81433739b287b6aa71620f15164f8096221b30"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7bda6eebafd42133efdca535b04ccb338ab29467b3f7bf79569883676fc628db"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:bbc8c8650c6e51041ad1be191742b8b421d05bbd3410f43fa2a00c8db87678e8"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:22c6f0c2fbc31e76c3b8a86fba1a56eda6166e238c29cdd3d14befdb4a4e4815"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7edbed096e4a4798710ed6bc75dcaa2a21b68b6c356553ac4823c3658d53743a"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:7f9019c9cb613f084481bd6a100b12e1547cf2efe362d873c2e31e4035a6fa43"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:58c948d0d086229efc484fe2f30c2d382c86720f55cd9bc33591774348ad44e0"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:419a9d91bd238052642a51938af8ac05da5b3343becde08d5cdeab9046df9ee1"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:5273b9f0b5835ff0350c0828faea623c68bfa65b792720c453e22b25cc72930f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:0e901eb1049fdb80f5bd11ed5ea1e498ec423102f7a9b9e4645d5b8204ff2815"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-win32.whl", hash = "sha256:b4ff1d35e8c5bd078be89349b6f3a845128e685e751b6ea1169cf2160b344c4d"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-win_amd64.whl", hash = "sha256:74119174722c4349af9708993118581686f343adc1c8c9c007d59be90d077f3f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314-win_arm64.whl", hash = "sha256:e5bcc1a1ae744e0bb59641171ae53743760130600da8db48cbb6e4918e186e4e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:ad8faf8df23f0378c6d527d8b0b15ea4a2e23c89376877c598c4870d1b2c7866"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f5ea69428fa1b49573eef0cc44a1d43bebd45ad0c611eb7d7eac760c7ae771bc"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:06a7e86163334edfc5d20fe104db92fcd666e5a5df0977cb5680a506fe26cc8e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e1f6e2f00a6b8edb562826e4632e26d063ac10307e80f7461f7de3ad8ef3f077"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95b52c68d64c1878818687a473a10547b3292e82b6f6fe483808fb1468e2f52f"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:7504e9b7dc05f99a9bbb4525c67a2c155073b44d720470a148b34166a69c054e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:172985e4ff804a7ad08eebec0a1640ece87ba5041d565fff23c8f99c1f389484"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:4be9f4830ba8741527693848403e2c457c16e499100963ec711b1c6f2049b7c7"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:79090741d842f564b1b2827c0b82d846405b744d31e84f18d7a7b41c20e473ff"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:87725cfb1a4f1f8c2fc9890ae2f42094120f4b44db9360be5d99a4c6b0e03a9e"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:fcce033e4021347d80ed9c66dcf1e7b1546319834b74445f561d2e2221de5659"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:ca0276464d148c72defa8bb4390cce01b4a0e425f3b50d1435aa6d7a18107602"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:197c1a244a274bb016dd8b79204850144ef77fe81c5b797dc389327adb552407"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-win32.whl", hash = "sha256:2a24157fa36980478dd1770b585c0f30d19e18f4fb0c47c13aa568f871718579"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-win_amd64.whl", hash = "sha256:cd5e2801c89992ed8c0a3f0293ae83c159a60d9a5d685005383ef4caca77f2c4"}, + {file = "charset_normalizer-3.4.6-cp314-cp314t-win_arm64.whl", hash = "sha256:47955475ac79cc504ef2704b192364e51d0d473ad452caedd0002605f780101c"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-macosx_10_9_universal2.whl", hash = "sha256:659a1e1b500fac8f2779dd9e1570464e012f43e580371470b45277a27baa7532"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f61aa92e4aad0be58eb6eb4e0c21acf32cf8065f4b2cae5665da756c4ceef982"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f50498891691e0864dc3da965f340fada0771f6142a378083dc4608f4ea513e2"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:bf625105bb9eef28a56a943fec8c8a98aeb80e7d7db99bd3c388137e6eb2d237"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:2bd9d128ef93637a5d7a6af25363cf5dec3fa21cf80e68055aad627f280e8afa"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux_2_31_armv7l.whl", hash = "sha256:d08ec48f0a1c48d75d0356cea971921848fb620fdeba805b28f937e90691209f"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:1ed80ff870ca6de33f4d953fda4d55654b9a2b340ff39ab32fa3adbcd718f264"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:f98059e4fcd3e3e4e2d632b7cf81c2faae96c43c60b569e9c621468082f1d104"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_armv7l.whl", hash = "sha256:ab30e5e3e706e3063bc6de96b118688cb10396b70bb9864a430f67df98c61ecc"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_ppc64le.whl", hash = "sha256:d5f5d1e9def3405f60e3ca8232d56f35c98fb7bf581efcc60051ebf53cb8b611"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_riscv64.whl", hash = "sha256:461598cd852bfa5a61b09cae2b1c02e2efcd166ee5516e243d540ac24bfa68a7"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_s390x.whl", hash = "sha256:71be7e0e01753a89cf024abf7ecb6bca2c81738ead80d43004d9b5e3f1244e64"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:df01808ee470038c3f8dc4f48620df7225c49c2d6639e38f96e6d6ac6e6f7b0e"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-win32.whl", hash = "sha256:69dd852c2f0ad631b8b60cfbe25a28c0058a894de5abb566619c205ce0550eae"}, + {file = "charset_normalizer-3.4.6-cp38-cp38-win_amd64.whl", hash = "sha256:517ad0e93394ac532745129ceabdf2696b609ec9f87863d337140317ebce1c14"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:31215157227939b4fb3d740cd23fe27be0439afef67b785a1eb78a3ae69cba9e"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ecbbd45615a6885fe3240eb9db73b9e62518b611850fdf8ab08bd56de7ad2b17"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c45a03a4c69820a399f1dda9e1d8fbf3562eda46e7720458180302021b08f778"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:e8aeb10fcbe92767f0fa69ad5a72deca50d0dca07fbde97848997d778a50c9fe"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:54fae94be3d75f3e573c9a1b5402dc593de19377013c9a0e4285e3d402dd3a2a"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux_2_31_armv7l.whl", hash = "sha256:2f7fdd9b6e6c529d6a2501a2d36b240109e78a8ceaef5687cfcfa2bbe671d297"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:4d1d02209e06550bdaef34af58e041ad71b88e624f5d825519da3a3308e22687"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:8bc5f0687d796c05b1e28ab0d38a50e6309906ee09375dd3aff6a9c09dd6e8f4"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:ee4ec14bc1680d6b0afab9aea2ef27e26d2024f18b24a2d7155a52b60da7e833"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_ppc64le.whl", hash = "sha256:d1a2ee9c1499fc8f86f4521f27a973c914b211ffa87322f4ee33bb35392da2c5"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:48696db7f18afb80a068821504296eb0787d9ce239b91ca15059d1d3eaacf13b"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_s390x.whl", hash = "sha256:4f41da960b196ea355357285ad1316a00099f22d0929fe168343b99b254729c9"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:802168e03fba8bbc5ce0d866d589e4b1ca751d06edee69f7f3a19c5a9fe6b597"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-win32.whl", hash = "sha256:8761ac29b6c81574724322a554605608a9960769ea83d2c73e396f3df896ad54"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-win_amd64.whl", hash = "sha256:1cf0a70018692f85172348fe06d3a4b63f94ecb055e13a00c644d368eb82e5b8"}, + {file = "charset_normalizer-3.4.6-cp39-cp39-win_arm64.whl", hash = "sha256:3516bbb8d42169de9e61b8520cbeeeb716f12f4ecfe3fd30a9919aa16c806ca8"}, + {file = "charset_normalizer-3.4.6-py3-none-any.whl", hash = "sha256:947cf925bc916d90adba35a64c82aace04fa39b46b52d4630ece166655905a69"}, + {file = "charset_normalizer-3.4.6.tar.gz", hash = "sha256:1ae6b62897110aa7c79ea2f5dd38d1abca6db663687c0b1ad9aed6f6bae3d9d6"}, ] [[package]] @@ -367,66 +384,61 @@ markers = {main = "sys_platform == \"win32\"", dev = "sys_platform == \"win32\" [[package]] name = "cryptography" -version = "46.0.3" +version = "46.0.6" description = "cryptography is a package which provides cryptographic recipes and primitives to Python developers." optional = false python-versions = "!=3.9.0,!=3.9.1,>=3.8" groups = ["dev"] files = [ - {file = "cryptography-46.0.3-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:109d4ddfadf17e8e7779c39f9b18111a09efb969a301a31e987416a0191ed93a"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:09859af8466b69bc3c27bdf4f5d84a665e0f7ab5088412e9e2ec49758eca5cbc"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:01ca9ff2885f3acc98c29f1860552e37f6d7c7d013d7334ff2a9de43a449315d"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:6eae65d4c3d33da080cff9c4ab1f711b15c1d9760809dad6ea763f3812d254cb"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5bf0ed4490068a2e72ac03d786693adeb909981cc596425d09032d372bcc849"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:5ecfccd2329e37e9b7112a888e76d9feca2347f12f37918facbb893d7bb88ee8"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:a2c0cd47381a3229c403062f764160d57d4d175e022c1df84e168c6251a22eec"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:549e234ff32571b1f4076ac269fcce7a808d3bf98b76c8dd560e42dbc66d7d91"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:c0a7bb1a68a5d3471880e264621346c48665b3bf1c3759d682fc0864c540bd9e"}, - {file = "cryptography-46.0.3-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:10b01676fc208c3e6feeb25a8b83d81767e8059e1fe86e1dc62d10a3018fa926"}, - {file = "cryptography-46.0.3-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:0abf1ffd6e57c67e92af68330d05760b7b7efb243aab8377e583284dbab72c71"}, - {file = "cryptography-46.0.3-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:a04bee9ab6a4da801eb9b51f1b708a1b5b5c9eb48c03f74198464c66f0d344ac"}, - {file = "cryptography-46.0.3-cp311-abi3-win32.whl", hash = "sha256:f260d0d41e9b4da1ed1e0f1ce571f97fe370b152ab18778e9e8f67d6af432018"}, - {file = "cryptography-46.0.3-cp311-abi3-win_amd64.whl", hash = "sha256:a9a3008438615669153eb86b26b61e09993921ebdd75385ddd748702c5adfddb"}, - {file = "cryptography-46.0.3-cp311-abi3-win_arm64.whl", hash = "sha256:5d7f93296ee28f68447397bf5198428c9aeeab45705a55d53a6343455dcb2c3c"}, - {file = "cryptography-46.0.3-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:00a5e7e87938e5ff9ff5447ab086a5706a957137e6e433841e9d24f38a065217"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c8daeb2d2174beb4575b77482320303f3d39b8e81153da4f0fb08eb5fe86a6c5"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:39b6755623145ad5eff1dab323f4eae2a32a77a7abef2c5089a04a3d04366715"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:db391fa7c66df6762ee3f00c95a89e6d428f4d60e7abc8328f4fe155b5ac6e54"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:78a97cf6a8839a48c49271cdcbd5cf37ca2c1d6b7fdd86cc864f302b5e9bf459"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:dfb781ff7eaa91a6f7fd41776ec37c5853c795d3b358d4896fdbb5df168af422"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:6f61efb26e76c45c4a227835ddeae96d83624fb0d29eb5df5b96e14ed1a0afb7"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:23b1a8f26e43f47ceb6d6a43115f33a5a37d57df4ea0ca295b780ae8546e8044"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:b419ae593c86b87014b9be7396b385491ad7f320bde96826d0dd174459e54665"}, - {file = "cryptography-46.0.3-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:50fc3343ac490c6b08c0cf0d704e881d0d660be923fd3076db3e932007e726e3"}, - {file = "cryptography-46.0.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:22d7e97932f511d6b0b04f2bfd818d73dcd5928db509460aaf48384778eb6d20"}, - {file = "cryptography-46.0.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:d55f3dffadd674514ad19451161118fd010988540cee43d8bc20675e775925de"}, - {file = "cryptography-46.0.3-cp314-cp314t-win32.whl", hash = "sha256:8a6e050cb6164d3f830453754094c086ff2d0b2f3a897a1d9820f6139a1f0914"}, - {file = "cryptography-46.0.3-cp314-cp314t-win_amd64.whl", hash = "sha256:760f83faa07f8b64e9c33fc963d790a2edb24efb479e3520c14a45741cd9b2db"}, - {file = "cryptography-46.0.3-cp314-cp314t-win_arm64.whl", hash = "sha256:516ea134e703e9fe26bcd1277a4b59ad30586ea90c365a87781d7887a646fe21"}, - {file = "cryptography-46.0.3-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:cb3d760a6117f621261d662bccc8ef5bc32ca673e037c83fbe565324f5c46936"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:4b7387121ac7d15e550f5cb4a43aef2559ed759c35df7336c402bb8275ac9683"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:15ab9b093e8f09daab0f2159bb7e47532596075139dd74365da52ecc9cb46c5d"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:46acf53b40ea38f9c6c229599a4a13f0d46a6c3fa9ef19fc1a124d62e338dfa0"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_28_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:10ca84c4668d066a9878890047f03546f3ae0a6b8b39b697457b7757aaf18dbc"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:36e627112085bb3b81b19fed209c05ce2a52ee8b15d161b7c643a7d5a88491f3"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:1000713389b75c449a6e979ffc7dcc8ac90b437048766cef052d4d30b8220971"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:b02cf04496f6576afffef5ddd04a0cb7d49cf6be16a9059d793a30b035f6b6ac"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:71e842ec9bc7abf543b47cf86b9a743baa95f4677d22baa4c7d5c69e49e9bc04"}, - {file = "cryptography-46.0.3-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:402b58fc32614f00980b66d6e56a5b4118e6cb362ae8f3fda141ba4689bd4506"}, - {file = "cryptography-46.0.3-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:ef639cb3372f69ec44915fafcd6698b6cc78fbe0c2ea41be867f6ed612811963"}, - {file = "cryptography-46.0.3-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:3b51b8ca4f1c6453d8829e1eb7299499ca7f313900dd4d89a24b8b87c0a780d4"}, - {file = "cryptography-46.0.3-cp38-abi3-win32.whl", hash = "sha256:6276eb85ef938dc035d59b87c8a7dc559a232f954962520137529d77b18ff1df"}, - {file = "cryptography-46.0.3-cp38-abi3-win_amd64.whl", hash = "sha256:416260257577718c05135c55958b674000baef9a1c7d9e8f306ec60d71db850f"}, - {file = "cryptography-46.0.3-cp38-abi3-win_arm64.whl", hash = "sha256:d89c3468de4cdc4f08a57e214384d0471911a3830fcdaf7a8cc587e42a866372"}, - {file = "cryptography-46.0.3-pp310-pypy310_pp73-macosx_10_9_x86_64.whl", hash = "sha256:a23582810fedb8c0bc47524558fb6c56aac3fc252cb306072fd2815da2a47c32"}, - {file = "cryptography-46.0.3-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:e7aec276d68421f9574040c26e2a7c3771060bc0cff408bae1dcb19d3ab1e63c"}, - {file = "cryptography-46.0.3-pp311-pypy311_pp73-macosx_10_9_x86_64.whl", hash = "sha256:7ce938a99998ed3c8aa7e7272dca1a610401ede816d36d0693907d863b10d9ea"}, - {file = "cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:191bb60a7be5e6f54e30ba16fdfae78ad3a342a0599eb4193ba88e3f3d6e185b"}, - {file = "cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c70cc23f12726be8f8bc72e41d5065d77e4515efae3690326764ea1b07845cfb"}, - {file = "cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:9394673a9f4de09e28b5356e7fff97d778f8abad85c9d5ac4a4b7e25a0de7717"}, - {file = "cryptography-46.0.3-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:94cd0549accc38d1494e1f8de71eca837d0509d0d44bf11d158524b0e12cebf9"}, - {file = "cryptography-46.0.3-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6b5063083824e5509fdba180721d55909ffacccc8adbec85268b48439423d78c"}, - {file = "cryptography-46.0.3.tar.gz", hash = "sha256:a8b17438104fed022ce745b362294d9ce35b4c2e45c1d958ad4a4b019285f4a1"}, + {file = "cryptography-46.0.6-cp311-abi3-macosx_10_9_universal2.whl", hash = "sha256:64235194bad039a10bb6d2d930ab3323baaec67e2ce36215fd0952fad0930ca8"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:26031f1e5ca62fcb9d1fcb34b2b60b390d1aacaa15dc8b895a9ed00968b97b30"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:9a693028b9cbe51b5a1136232ee8f2bc242e4e19d456ded3fa7c86e43c713b4a"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:67177e8a9f421aa2d3a170c3e56eca4e0128883cf52a071a7cbf53297f18b175"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:d9528b535a6c4f8ff37847144b8986a9a143585f0540fbcb1a98115b543aa463"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:22259338084d6ae497a19bae5d4c66b7ca1387d3264d1c2c0e72d9e9b6a77b97"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:760997a4b950ff00d418398ad73fbc91aa2894b5c1db7ccb45b4f68b42a63b3c"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:3dfa6567f2e9e4c5dceb8ccb5a708158a2a871052fa75c8b78cb0977063f1507"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:cdcd3edcbc5d55757e5f5f3d330dd00007ae463a7e7aa5bf132d1f22a4b62b19"}, + {file = "cryptography-46.0.6-cp311-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:d4e4aadb7fc1f88687f47ca20bb7227981b03afaae69287029da08096853b738"}, + {file = "cryptography-46.0.6-cp311-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:2b417edbe8877cda9022dde3a008e2deb50be9c407eef034aeeb3a8b11d9db3c"}, + {file = "cryptography-46.0.6-cp311-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:380343e0653b1c9d7e1f55b52aaa2dbb2fdf2730088d48c43ca1c7c0abb7cc2f"}, + {file = "cryptography-46.0.6-cp311-abi3-win32.whl", hash = "sha256:bcb87663e1f7b075e48c3be3ecb5f0b46c8fc50b50a97cf264e7f60242dca3f2"}, + {file = "cryptography-46.0.6-cp311-abi3-win_amd64.whl", hash = "sha256:6739d56300662c468fddb0e5e291f9b4d084bead381667b9e654c7dd81705124"}, + {file = "cryptography-46.0.6-cp314-cp314t-macosx_10_9_universal2.whl", hash = "sha256:2ef9e69886cbb137c2aef9772c2e7138dc581fad4fcbcf13cc181eb5a3ab6275"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:7f417f034f91dcec1cb6c5c35b07cdbb2ef262557f701b4ecd803ee8cefed4f4"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:d24c13369e856b94892a89ddf70b332e0b70ad4a5c43cf3e9cb71d6d7ffa1f7b"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_aarch64.whl", hash = "sha256:aad75154a7ac9039936d50cf431719a2f8d4ed3d3c277ac03f3339ded1a5e707"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_ppc64le.whl", hash = "sha256:3c21d92ed15e9cfc6eb64c1f5a0326db22ca9c2566ca46d845119b45b4400361"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_28_x86_64.whl", hash = "sha256:4668298aef7cddeaf5c6ecc244c2302a2b8e40f384255505c22875eebb47888b"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:8ce35b77aaf02f3b59c90b2c8a05c73bac12cea5b4e8f3fbece1f5fddea5f0ca"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_aarch64.whl", hash = "sha256:c89eb37fae9216985d8734c1afd172ba4927f5a05cfd9bf0e4863c6d5465b013"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_ppc64le.whl", hash = "sha256:ed418c37d095aeddf5336898a132fba01091f0ac5844e3e8018506f014b6d2c4"}, + {file = "cryptography-46.0.6-cp314-cp314t-manylinux_2_34_x86_64.whl", hash = "sha256:69cf0056d6947edc6e6760e5f17afe4bea06b56a9ac8a06de9d2bd6b532d4f3a"}, + {file = "cryptography-46.0.6-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8e7304c4f4e9490e11efe56af6713983460ee0780f16c63f219984dab3af9d2d"}, + {file = "cryptography-46.0.6-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b928a3ca837c77a10e81a814a693f2295200adb3352395fad024559b7be7a736"}, + {file = "cryptography-46.0.6-cp314-cp314t-win32.whl", hash = "sha256:97c8115b27e19e592a05c45d0dd89c57f81f841cc9880e353e0d3bf25b2139ed"}, + {file = "cryptography-46.0.6-cp314-cp314t-win_amd64.whl", hash = "sha256:c797e2517cb7880f8297e2c0f43bb910e91381339336f75d2c1c2cbf811b70b4"}, + {file = "cryptography-46.0.6-cp38-abi3-macosx_10_9_universal2.whl", hash = "sha256:12cae594e9473bca1a7aceb90536060643128bb274fcea0fc459ab90f7d1ae7a"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:639301950939d844a9e1c4464d7e07f902fe9a7f6b215bb0d4f28584729935d8"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:ed3775295fb91f70b4027aeba878d79b3e55c0b3e97eaa4de71f8f23a9f2eb77"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_aarch64.whl", hash = "sha256:8927ccfbe967c7df312ade694f987e7e9e22b2425976ddbf28271d7e58845290"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_ppc64le.whl", hash = "sha256:b12c6b1e1651e42ab5de8b1e00dc3b6354fdfd778e7fa60541ddacc27cd21410"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_28_x86_64.whl", hash = "sha256:063b67749f338ca9c5a0b7fe438a52c25f9526b851e24e6c9310e7195aad3b4d"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_31_armv7l.whl", hash = "sha256:02fad249cb0e090b574e30b276a3da6a149e04ee2f049725b1f69e7b8351ec70"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_aarch64.whl", hash = "sha256:7e6142674f2a9291463e5e150090b95a8519b2fb6e6aaec8917dd8d094ce750d"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_ppc64le.whl", hash = "sha256:456b3215172aeefb9284550b162801d62f5f264a081049a3e94307fe20792cfa"}, + {file = "cryptography-46.0.6-cp38-abi3-manylinux_2_34_x86_64.whl", hash = "sha256:341359d6c9e68834e204ceaf25936dffeafea3829ab80e9503860dcc4f4dac58"}, + {file = "cryptography-46.0.6-cp38-abi3-musllinux_1_2_aarch64.whl", hash = "sha256:9a9c42a2723999a710445bc0d974e345c32adfd8d2fac6d8a251fa829ad31cfb"}, + {file = "cryptography-46.0.6-cp38-abi3-musllinux_1_2_x86_64.whl", hash = "sha256:6617f67b1606dfd9fe4dbfa354a9508d4a6d37afe30306fe6c101b7ce3274b72"}, + {file = "cryptography-46.0.6-cp38-abi3-win32.whl", hash = "sha256:7f6690b6c55e9c5332c0b59b9c8a3fb232ebf059094c17f9019a51e9827df91c"}, + {file = "cryptography-46.0.6-cp38-abi3-win_amd64.whl", hash = "sha256:79e865c642cfc5c0b3eb12af83c35c5aeff4fa5c672dc28c43721c2c9fdd2f0f"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-macosx_11_0_arm64.whl", hash = "sha256:2ea0f37e9a9cf0df2952893ad145fd9627d326a59daec9b0802480fa3bcd2ead"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:a3e84d5ec9ba01f8fd03802b2147ba77f0c8f2617b2aff254cedd551844209c8"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:12f0fa16cc247b13c43d56d7b35287ff1569b5b1f4c5e87e92cc4fcc00cd10c0"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_aarch64.whl", hash = "sha256:50575a76e2951fe7dbd1f56d181f8c5ceeeb075e9ff88e7ad997d2f42af06e7b"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-manylinux_2_34_x86_64.whl", hash = "sha256:90e5f0a7b3be5f40c3a0a0eafb32c681d8d2c181fc2a1bdabe9b3f611d9f6b1a"}, + {file = "cryptography-46.0.6-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:6728c49e3b2c180ef26f8e9f0a883a2c585638db64cf265b49c9ba10652d430e"}, + {file = "cryptography-46.0.6.tar.gz", hash = "sha256:27550628a518c5c6c903d84f637fbecf287f6cb9ced3804838a1295dc1fd0759"}, ] [package.dependencies] @@ -440,7 +452,7 @@ nox = ["nox[uv] (>=2024.4.15)"] pep8test = ["check-sdist", "click (>=8.0.1)", "mypy (>=1.14)", "ruff (>=0.11.11)"] sdist = ["build (>=1.0.0)"] ssh = ["bcrypt (>=3.1.5)"] -test = ["certifi (>=2024)", "cryptography-vectors (==46.0.3)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"] +test = ["certifi (>=2024)", "cryptography-vectors (==46.0.6)", "pretend (>=0.7)", "pytest (>=7.4.0)", "pytest-benchmark (>=4.0)", "pytest-cov (>=2.10.1)", "pytest-xdist (>=3.5.0)"] test-randomorder = ["pytest-randomly"] [[package]] @@ -519,14 +531,14 @@ smmap = ">=3.0.1,<6" [[package]] name = "gitpython" -version = "3.1.45" +version = "3.1.46" description = "GitPython is a Python library used to interact with Git repositories" optional = false python-versions = ">=3.7" groups = ["main"] files = [ - {file = "gitpython-3.1.45-py3-none-any.whl", hash = "sha256:8908cb2e02fb3b93b7eb0f2827125cb699869470432cc885f019b8fd0fccff77"}, - {file = "gitpython-3.1.45.tar.gz", hash = "sha256:85b0ee964ceddf211c41b9f27a49086010a190fd8132a24e21f362a4b36a791c"}, + {file = "gitpython-3.1.46-py3-none-any.whl", hash = "sha256:79812ed143d9d25b6d176a10bb511de0f9c67b1fa641d82097b0ab90398a2058"}, + {file = "gitpython-3.1.46.tar.gz", hash = "sha256:400124c7d0ef4ea03f7310ac2fbf7151e09ff97f2a3288d64a440c584a29c37f"}, ] [package.dependencies] @@ -534,7 +546,7 @@ gitdb = ">=4.0.1,<5" [package.extras] doc = ["sphinx (>=7.1.2,<7.2)", "sphinx-autodoc-typehints", "sphinx_rtd_theme"] -test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock ; python_version < \"3.8\"", "mypy", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions ; python_version < \"3.11\""] +test = ["coverage[toml]", "ddt (>=1.1.1,!=1.4.3)", "mock ; python_version < \"3.8\"", "mypy (==1.18.2) ; python_version >= \"3.9\"", "pre-commit", "pytest (>=7.3.1)", "pytest-cov", "pytest-instafail", "pytest-mock", "pytest-sugar", "typing-extensions ; python_version < \"3.11\""] [[package]] name = "idna" @@ -611,21 +623,21 @@ six = "*" [[package]] name = "jsonschema" -version = "4.25.1" +version = "4.26.0" description = "An implementation of JSON Schema validation for Python" optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["main"] files = [ - {file = "jsonschema-4.25.1-py3-none-any.whl", hash = "sha256:3fba0169e345c7175110351d456342c364814cfcf3b964ba4587f22915230a63"}, - {file = "jsonschema-4.25.1.tar.gz", hash = "sha256:e4a9655ce0da0c0b67a085847e00a3a51449e1157f4f75e9fb5aa545e122eb85"}, + {file = "jsonschema-4.26.0-py3-none-any.whl", hash = "sha256:d489f15263b8d200f8387e64b4c3a75f06629559fb73deb8fdfb525f2dab50ce"}, + {file = "jsonschema-4.26.0.tar.gz", hash = "sha256:0c26707e2efad8aa1bfc5b7ce170f3fccc2e4918ff85989ba9ffa9facb2be326"}, ] [package.dependencies] attrs = ">=22.2.0" jsonschema-specifications = ">=2023.3.6" referencing = ">=0.28.4" -rpds-py = ">=0.7.1" +rpds-py = ">=0.25.0" [package.extras] format = ["fqdn", "idna", "isoduration", "jsonpointer (>1.13)", "rfc3339-validator", "rfc3987", "uri-template", "webcolors (>=1.11)"] @@ -1031,26 +1043,26 @@ openapi-schema-validator = ">=0.6.0,<0.7.0" [[package]] name = "packaging" -version = "25.0" +version = "26.0" description = "Core utilities for Python packages" optional = false python-versions = ">=3.8" groups = ["main", "dev"] files = [ - {file = "packaging-25.0-py3-none-any.whl", hash = "sha256:29572ef2b1f17581046b3a2227d5c611fb25ec70ca1ba8554b24b0e69331a484"}, - {file = "packaging-25.0.tar.gz", hash = "sha256:d443872c98d677bf60f6a1f2f8c1cb748e8fe762d2bf9d3148b5599295b0fc4f"}, + {file = "packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529"}, + {file = "packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4"}, ] [[package]] name = "parse" -version = "1.20.2" +version = "1.21.1" description = "parse() is the opposite of format()" optional = false python-versions = "*" groups = ["main"] files = [ - {file = "parse-1.20.2-py2.py3-none-any.whl", hash = "sha256:967095588cb802add9177d0c0b6133b5ba33b1ea9007ca800e526f42a85af558"}, - {file = "parse-1.20.2.tar.gz", hash = "sha256:b41d604d16503c79d81af5165155c0b20f6c8d6c559efa66b4b695c3e5a0a0ce"}, + {file = "parse-1.21.1-py2.py3-none-any.whl", hash = "sha256:55339ca698019815df3b8e8b550e5933933527e623b0cdf1ca2f404da35ffb47"}, + {file = "parse-1.21.1.tar.gz", hash = "sha256:825e1a88e9d9fb481b8d2ca709c6195558b6eaa97c559ad3a9a20aa2d12815a3"}, ] [[package]] @@ -1067,26 +1079,32 @@ files = [ [[package]] name = "pathspec" -version = "0.12.1" +version = "1.0.4" description = "Utility library for gitignore style pattern matching of file paths." optional = false -python-versions = ">=3.8" +python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "pathspec-0.12.1-py3-none-any.whl", hash = "sha256:a0d503e138a4c123b27490a4f7beda6a01c6f288df0e4a8b79c7eb0dc7b4cc08"}, - {file = "pathspec-0.12.1.tar.gz", hash = "sha256:a482d51503a1ab33b1c67a6c3813a26953dbdc71c31dacaef9a838c4e29f5712"}, + {file = "pathspec-1.0.4-py3-none-any.whl", hash = "sha256:fb6ae2fd4e7c921a165808a552060e722767cfa526f99ca5156ed2ce45a5c723"}, + {file = "pathspec-1.0.4.tar.gz", hash = "sha256:0210e2ae8a21a9137c0d470578cb0e595af87edaa6ebf12ff176f14a02e0e645"}, ] +[package.extras] +hyperscan = ["hyperscan (>=0.7)"] +optional = ["typing-extensions (>=4)"] +re2 = ["google-re2 (>=1.1)"] +tests = ["pytest (>=9)", "typing-extensions (>=4.15)"] + [[package]] name = "pip-licenses" -version = "5.5.0" +version = "5.5.5" description = "Dump the software license list of Python packages installed with pip." optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "pip_licenses-5.5.0-py3-none-any.whl", hash = "sha256:ae1869436d13ee487088d29e71fc5821950062ad25ec28b6a1a443e0add6d8e8"}, - {file = "pip_licenses-5.5.0.tar.gz", hash = "sha256:2473e7afd02a0c21460758f70fd2bb3b3c080c5150713dd33baa9493dc1563a5"}, + {file = "pip_licenses-5.5.5-py3-none-any.whl", hash = "sha256:f4c4c6d9e6a03612cf59f29f19dc8ab54904d82e055b8e191498f2279a224e14"}, + {file = "pip_licenses-5.5.5.tar.gz", hash = "sha256:60750c006adf7a0910347b726e8ee9fee3bc8d2e7c8307a5c4ec0776c8e2a276"}, ] [package.dependencies] @@ -1094,25 +1112,20 @@ prettytable = ">=3.12.0" tomli = {version = ">=2", markers = "python_version < \"3.11\""} [package.extras] -dev = ["autopep8", "black", "docutils", "isort", "mypy", "pip-tools", "pypandoc", "pytest-cov", "pytest-pycodestyle", "pytest-runner", "tomli-w", "twine", "wheel"] +dev = ["docutils (>=0.19)", "mypy", "pip-tools", "pypandoc", "pytest-cov", "pytest-runner", "ruff", "tomli-w", "virtualenv (>=21.1.0)", "wheel"] [[package]] name = "platformdirs" -version = "4.5.0" +version = "4.9.4" description = "A small Python package for determining appropriate platform-specific dirs, e.g. a `user data dir`." optional = false python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "platformdirs-4.5.0-py3-none-any.whl", hash = "sha256:e578a81bb873cbb89a41fcc904c7ef523cc18284b7e3b3ccf06aca1403b7ebd3"}, - {file = "platformdirs-4.5.0.tar.gz", hash = "sha256:70ddccdd7c99fc5942e9fc25636a8b34d04c24b335100223152c2803e4063312"}, + {file = "platformdirs-4.9.4-py3-none-any.whl", hash = "sha256:68a9a4619a666ea6439f2ff250c12a853cd1cbd5158d258bd824a7df6be2f868"}, + {file = "platformdirs-4.9.4.tar.gz", hash = "sha256:1ec356301b7dc906d83f371c8f487070e99d3ccf9e501686456394622a01a934"}, ] -[package.extras] -docs = ["furo (>=2025.9.25)", "proselint (>=0.14)", "sphinx (>=8.2.3)", "sphinx-autodoc-typehints (>=3.2)"] -test = ["appdirs (==1.4.4)", "covdefaults (>=2.3)", "pytest (>=8.4.2)", "pytest-cov (>=7)", "pytest-mock (>=3.15.1)"] -type = ["mypy (>=1.18.2)"] - [[package]] name = "pluggy" version = "1.6.0" @@ -1173,15 +1186,15 @@ files = [ [[package]] name = "pycparser" -version = "2.23" +version = "3.0" description = "C parser in Python" optional = false -python-versions = ">=3.8" +python-versions = ">=3.10" groups = ["dev"] markers = "platform_python_implementation != \"PyPy\" and implementation_name != \"PyPy\"" files = [ - {file = "pycparser-2.23-py3-none-any.whl", hash = "sha256:e5c6e8d3fbad53479cab09ac03729e0a9faf2bee3db8208a550daf5af81a5934"}, - {file = "pycparser-2.23.tar.gz", hash = "sha256:78816d4f24add8f10a06d6f05b4d424ad9e96cfebf68a4ddc99c65c0720d00c2"}, + {file = "pycparser-3.0-py3-none-any.whl", hash = "sha256:b727414169a36b7d524c1c3e31839a521725078d7b2ff038656844266160a992"}, + {file = "pycparser-3.0.tar.gz", hash = "sha256:600f49d217304a5902ac3c37e1281c9fe94e4d0489de643a9504c5cdfdfc6b29"}, ] [[package]] @@ -1393,14 +1406,14 @@ typing-extensions = ">=4.14.1" [[package]] name = "pydantic-settings" -version = "2.12.0" +version = "2.13.1" description = "Settings management using Pydantic" optional = false python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809"}, - {file = "pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0"}, + {file = "pydantic_settings-2.13.1-py3-none-any.whl", hash = "sha256:d56fd801823dbeae7f0975e1f8c8e25c258eb75d278ea7abb5d9cebb01b56237"}, + {file = "pydantic_settings-2.13.1.tar.gz", hash = "sha256:b4c11847b15237fb0171e1462bf540e294affb9b86db4d9aa5c01730bdbe4025"}, ] [package.dependencies] @@ -1429,14 +1442,14 @@ files = [ [[package]] name = "pygments" -version = "2.19.2" +version = "2.20.0" description = "Pygments is a syntax highlighting package written in Python." optional = false -python-versions = ">=3.8" +python-versions = ">=3.9" groups = ["main", "dev"] files = [ - {file = "pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b"}, - {file = "pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887"}, + {file = "pygments-2.20.0-py3-none-any.whl", hash = "sha256:81a9e26dd42fd28a23a2d169d86d7ac03b46e2f8b59ed4698fb4785f946d0176"}, + {file = "pygments-2.20.0.tar.gz", hash = "sha256:6757cd03768053ff99f3039c1a36d6c0aa0b263438fcab17520b30a303a82b5f"}, ] [package.extras] @@ -1444,21 +1457,24 @@ windows-terminal = ["colorama (>=0.4.6)"] [[package]] name = "pyjwt" -version = "2.10.1" +version = "2.12.1" description = "JSON Web Token implementation in Python" optional = false python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "PyJWT-2.10.1-py3-none-any.whl", hash = "sha256:dcdd193e30abefd5debf142f9adfcdd2b58004e644f25406ffaebd50bd98dacb"}, - {file = "pyjwt-2.10.1.tar.gz", hash = "sha256:3cc5772eb20009233caf06e9d8a0577824723b44e6648ee0a2aedb6cf9381953"}, + {file = "pyjwt-2.12.1-py3-none-any.whl", hash = "sha256:28ca37c070cad8ba8cd9790cd940535d40274d22f80ab87f3ac6a713e6e8454c"}, + {file = "pyjwt-2.12.1.tar.gz", hash = "sha256:c74a7a2adf861c04d002db713dd85f84beb242228e671280bf709d765b03672b"}, ] +[package.dependencies] +typing_extensions = {version = ">=4.0", markers = "python_version < \"3.11\""} + [package.extras] crypto = ["cryptography (>=3.4.0)"] -dev = ["coverage[toml] (==5.0.4)", "cryptography (>=3.4.0)", "pre-commit", "pytest (>=6.0.0,<7.0.0)", "sphinx", "sphinx-rtd-theme", "zope.interface"] +dev = ["coverage[toml] (==7.10.7)", "cryptography (>=3.4.0)", "pre-commit", "pytest (>=8.4.2,<9.0.0)", "sphinx", "sphinx-rtd-theme", "zope.interface"] docs = ["sphinx", "sphinx-rtd-theme", "zope.interface"] -tests = ["coverage[toml] (==5.0.4)", "pytest (>=6.0.0,<7.0.0)"] +tests = ["coverage[toml] (==7.10.7)", "pytest (>=8.4.2,<9.0.0)"] [[package]] name = "pyotp" @@ -1522,14 +1538,14 @@ testing = ["coverage (>=6.2)", "hypothesis (>=5.7.1)"] [[package]] name = "pytest-check" -version = "2.6.2" +version = "2.8.0" description = "A pytest plugin that allows multiple failures per test." optional = false python-versions = ">=3.9" groups = ["main"] files = [ - {file = "pytest_check-2.6.2-py3-none-any.whl", hash = "sha256:71762eb58f6b8a2d75afb9e6c8b800af7f634f67359d899a65ee48aaee087215"}, - {file = "pytest_check-2.6.2.tar.gz", hash = "sha256:5e2128405b14978ad74f21f3225fcc52bbb1cc7c41a55d5eaad9f1e3cd27e42e"}, + {file = "pytest_check-2.8.0-py3-none-any.whl", hash = "sha256:671d94f857cebb4a4195baaf064ad77e3af8c37d0428dabdcfc3dcc992761634"}, + {file = "pytest_check-2.8.0.tar.gz", hash = "sha256:c42e08ddd41ad9c387bd16efa664ade5def4d7aa5c607b05ba9e25f5aaba70c2"}, ] [package.dependencies] @@ -1568,14 +1584,14 @@ wheel = ">=0.37.1,<0.39.0" [[package]] name = "python-dotenv" -version = "1.2.1" +version = "1.2.2" description = "Read key-value pairs from a .env file and set them as environment variables" optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61"}, - {file = "python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6"}, + {file = "python_dotenv-1.2.2-py3-none-any.whl", hash = "sha256:1d8214789a24de455a8b8bd8ae6fe3c6b69a5e3d64aa8a8e5d68e694bbcb285a"}, + {file = "python_dotenv-1.2.2.tar.gz", hash = "sha256:2c371a91fbd7ba082c2c1dc1f8bf89ca22564a087c2c287cd9b662adde799cf3"}, ] [package.extras] @@ -1583,14 +1599,54 @@ cli = ["click (>=5.0)"] [[package]] name = "pytokens" -version = "0.3.0" +version = "0.4.1" description = "A Fast, spec compliant Python 3.14+ tokenizer that runs on older Pythons." optional = false python-versions = ">=3.8" groups = ["dev"] files = [ - {file = "pytokens-0.3.0-py3-none-any.whl", hash = "sha256:95b2b5eaf832e469d141a378872480ede3f251a5a5041b8ec6e581d3ac71bbf3"}, - {file = "pytokens-0.3.0.tar.gz", hash = "sha256:2f932b14ed08de5fcf0b391ace2642f858f1394c0857202959000b68ed7a458a"}, + {file = "pytokens-0.4.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:2a44ed93ea23415c54f3face3b65ef2b844d96aeb3455b8a69b3df6beab6acc5"}, + {file = "pytokens-0.4.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:add8bf86b71a5d9fb5b89f023a80b791e04fba57960aa790cc6125f7f1d39dfe"}, + {file = "pytokens-0.4.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:670d286910b531c7b7e3c0b453fd8156f250adb140146d234a82219459b9640c"}, + {file = "pytokens-0.4.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:4e691d7f5186bd2842c14813f79f8884bb03f5995f0575272009982c5ac6c0f7"}, + {file = "pytokens-0.4.1-cp310-cp310-win_amd64.whl", hash = "sha256:27b83ad28825978742beef057bfe406ad6ed524b2d28c252c5de7b4a6dd48fa2"}, + {file = "pytokens-0.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:d70e77c55ae8380c91c0c18dea05951482e263982911fc7410b1ffd1dadd3440"}, + {file = "pytokens-0.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4a58d057208cb9075c144950d789511220b07636dd2e4708d5645d24de666bdc"}, + {file = "pytokens-0.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b49750419d300e2b5a3813cf229d4e5a4c728dae470bcc89867a9ad6f25a722d"}, + {file = "pytokens-0.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:d9907d61f15bf7261d7e775bd5d7ee4d2930e04424bab1972591918497623a16"}, + {file = "pytokens-0.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:ee44d0f85b803321710f9239f335aafe16553b39106384cef8e6de40cb4ef2f6"}, + {file = "pytokens-0.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:140709331e846b728475786df8aeb27d24f48cbcf7bcd449f8de75cae7a45083"}, + {file = "pytokens-0.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6d6c4268598f762bc8e91f5dbf2ab2f61f7b95bdc07953b602db879b3c8c18e1"}, + {file = "pytokens-0.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:24afde1f53d95348b5a0eb19488661147285ca4dd7ed752bbc3e1c6242a304d1"}, + {file = "pytokens-0.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5ad948d085ed6c16413eb5fec6b3e02fa00dc29a2534f088d3302c47eb59adf9"}, + {file = "pytokens-0.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:3f901fe783e06e48e8cbdc82d631fca8f118333798193e026a50ce1b3757ea68"}, + {file = "pytokens-0.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:8bdb9d0ce90cbf99c525e75a2fa415144fd570a1ba987380190e8b786bc6ef9b"}, + {file = "pytokens-0.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5502408cab1cb18e128570f8d598981c68a50d0cbd7c61312a90507cd3a1276f"}, + {file = "pytokens-0.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:29d1d8fb1030af4d231789959f21821ab6325e463f0503a61d204343c9b355d1"}, + {file = "pytokens-0.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:970b08dd6b86058b6dc07efe9e98414f5102974716232d10f32ff39701e841c4"}, + {file = "pytokens-0.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:9bd7d7f544d362576be74f9d5901a22f317efc20046efe2034dced238cbbfe78"}, + {file = "pytokens-0.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4a14d5f5fc78ce85e426aa159489e2d5961acf0e47575e08f35584009178e321"}, + {file = "pytokens-0.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:97f50fd18543be72da51dd505e2ed20d2228c74e0464e4262e4899797803d7fa"}, + {file = "pytokens-0.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:dc74c035f9bfca0255c1af77ddd2d6ae8419012805453e4b0e7513e17904545d"}, + {file = "pytokens-0.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f66a6bbe741bd431f6d741e617e0f39ec7257ca1f89089593479347cc4d13324"}, + {file = "pytokens-0.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:b35d7e5ad269804f6697727702da3c517bb8a5228afa450ab0fa787732055fc9"}, + {file = "pytokens-0.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:8fcb9ba3709ff77e77f1c7022ff11d13553f3c30299a9fe246a166903e9091eb"}, + {file = "pytokens-0.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:79fc6b8699564e1f9b521582c35435f1bd32dd06822322ec44afdeba666d8cb3"}, + {file = "pytokens-0.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d31b97b3de0f61571a124a00ffe9a81fb9939146c122c11060725bd5aea79975"}, + {file = "pytokens-0.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:967cf6e3fd4adf7de8fc73cd3043754ae79c36475c1c11d514fc72cf5490094a"}, + {file = "pytokens-0.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:584c80c24b078eec1e227079d56dc22ff755e0ba8654d8383b2c549107528918"}, + {file = "pytokens-0.4.1-cp38-cp38-macosx_11_0_arm64.whl", hash = "sha256:da5baeaf7116dced9c6bb76dc31ba04a2dc3695f3d9f74741d7910122b456edc"}, + {file = "pytokens-0.4.1-cp38-cp38-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:11edda0942da80ff58c4408407616a310adecae1ddd22eef8c692fe266fa5009"}, + {file = "pytokens-0.4.1-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0fc71786e629cef478cbf29d7ea1923299181d0699dbe7c3c0f4a583811d9fc1"}, + {file = "pytokens-0.4.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:dcafc12c30dbaf1e2af0490978352e0c4041a7cde31f4f81435c2a5e8b9cabb6"}, + {file = "pytokens-0.4.1-cp38-cp38-win_amd64.whl", hash = "sha256:42f144f3aafa5d92bad964d471a581651e28b24434d184871bd02e3a0d956037"}, + {file = "pytokens-0.4.1-cp39-cp39-macosx_11_0_arm64.whl", hash = "sha256:34bcc734bd2f2d5fe3b34e7b3c0116bfb2397f2d9666139988e7a3eb5f7400e3"}, + {file = "pytokens-0.4.1-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:941d4343bf27b605e9213b26bfa1c4bf197c9c599a9627eb7305b0defcfe40c1"}, + {file = "pytokens-0.4.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3ad72b851e781478366288743198101e5eb34a414f1d5627cdd585ca3b25f1db"}, + {file = "pytokens-0.4.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:682fa37ff4d8e95f7df6fe6fe6a431e8ed8e788023c6bcc0f0880a12eab80ad1"}, + {file = "pytokens-0.4.1-cp39-cp39-win_amd64.whl", hash = "sha256:30f51edd9bb7f85c748979384165601d028b84f7bd13fe14d3e065304093916a"}, + {file = "pytokens-0.4.1-py3-none-any.whl", hash = "sha256:26cef14744a8385f35d0e095dc8b3a7583f6c953c2e3d269c7f82484bf5ad2de"}, + {file = "pytokens-0.4.1.tar.gz", hash = "sha256:292052fe80923aae2260c073f822ceba21f3872ced9a68bb7953b348e561179a"}, ] [package.extras] @@ -1698,25 +1754,26 @@ typing-extensions = {version = ">=4.4.0", markers = "python_version < \"3.13\""} [[package]] name = "requests" -version = "2.32.5" +version = "2.33.0" description = "Python HTTP for Humans." optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["main", "dev"] files = [ - {file = "requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6"}, - {file = "requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf"}, + {file = "requests-2.33.0-py3-none-any.whl", hash = "sha256:3324635456fa185245e24865e810cecec7b4caf933d7eb133dcde67d48cee69b"}, + {file = "requests-2.33.0.tar.gz", hash = "sha256:c7ebc5e8b0f21837386ad0e1c8fe8b829fa5f544d8df3b2253bff14ef29d7652"}, ] [package.dependencies] -certifi = ">=2017.4.17" +certifi = ">=2023.5.7" charset_normalizer = ">=2,<4" idna = ">=2.5,<4" -urllib3 = ">=1.21.1,<3" +urllib3 = ">=1.26,<3" [package.extras] socks = ["PySocks (>=1.5.6,!=1.5.7)"] -use-chardet-on-py3 = ["chardet (>=3.0.2,<6)"] +test = ["PySocks (>=1.5.6,!=1.5.7)", "pytest (>=3)", "pytest-cov", "pytest-httpbin (==2.1.0)", "pytest-mock", "pytest-xdist"] +use-chardet-on-py3 = ["chardet (>=3.0.2,<8)"] [[package]] name = "rfc3339-validator" @@ -1884,14 +1941,14 @@ files = [ [[package]] name = "smmap" -version = "5.0.2" +version = "5.0.3" description = "A pure Python implementation of a sliding window memory map manager" optional = false python-versions = ">=3.7" groups = ["main"] files = [ - {file = "smmap-5.0.2-py3-none-any.whl", hash = "sha256:b30115f0def7d7531d22a0fb6502488d879e75b260a9db4d0819cfb25403af5e"}, - {file = "smmap-5.0.2.tar.gz", hash = "sha256:26ea65a03958fa0c8a1c7e8c7a58fdc77221b8910f6be2131affade476898ad5"}, + {file = "smmap-5.0.3-py3-none-any.whl", hash = "sha256:c106e05d5a61449cf6ba9a1e650227ecfb141590d2a98412103ff35d89fc7b2f"}, + {file = "smmap-5.0.3.tar.gz", hash = "sha256:4d9debb8b99007ae47165abc08670bd74cb74b5227dda7f643eccc4e9eb5642c"}, ] [[package]] @@ -1908,55 +1965,60 @@ files = [ [[package]] name = "tomli" -version = "2.3.0" +version = "2.4.1" description = "A lil' TOML parser" optional = false python-versions = ">=3.8" groups = ["main", "dev"] markers = "python_version == \"3.10\"" files = [ - {file = "tomli-2.3.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:88bd15eb972f3664f5ed4b57c1634a97153b4bac4479dcb6a495f41921eb7f45"}, - {file = "tomli-2.3.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:883b1c0d6398a6a9d29b508c331fa56adbcdff647f6ace4dfca0f50e90dfd0ba"}, - {file = "tomli-2.3.0-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d1381caf13ab9f300e30dd8feadb3de072aeb86f1d34a8569453ff32a7dea4bf"}, - {file = "tomli-2.3.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a0e285d2649b78c0d9027570d4da3425bdb49830a6156121360b3f8511ea3441"}, - {file = "tomli-2.3.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:0a154a9ae14bfcf5d8917a59b51ffd5a3ac1fd149b71b47a3a104ca4edcfa845"}, - {file = "tomli-2.3.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:74bf8464ff93e413514fefd2be591c3b0b23231a77f901db1eb30d6f712fc42c"}, - {file = "tomli-2.3.0-cp311-cp311-win32.whl", hash = "sha256:00b5f5d95bbfc7d12f91ad8c593a1659b6387b43f054104cda404be6bda62456"}, - {file = "tomli-2.3.0-cp311-cp311-win_amd64.whl", hash = "sha256:4dc4ce8483a5d429ab602f111a93a6ab1ed425eae3122032db7e9acf449451be"}, - {file = "tomli-2.3.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:d7d86942e56ded512a594786a5ba0a5e521d02529b3826e7761a05138341a2ac"}, - {file = "tomli-2.3.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:73ee0b47d4dad1c5e996e3cd33b8a76a50167ae5f96a2607cbe8cc773506ab22"}, - {file = "tomli-2.3.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:792262b94d5d0a466afb5bc63c7daa9d75520110971ee269152083270998316f"}, - {file = "tomli-2.3.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4f195fe57ecceac95a66a75ac24d9d5fbc98ef0962e09b2eddec5d39375aae52"}, - {file = "tomli-2.3.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:e31d432427dcbf4d86958c184b9bfd1e96b5b71f8eb17e6d02531f434fd335b8"}, - {file = "tomli-2.3.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:7b0882799624980785240ab732537fcfc372601015c00f7fc367c55308c186f6"}, - {file = "tomli-2.3.0-cp312-cp312-win32.whl", hash = "sha256:ff72b71b5d10d22ecb084d345fc26f42b5143c5533db5e2eaba7d2d335358876"}, - {file = "tomli-2.3.0-cp312-cp312-win_amd64.whl", hash = "sha256:1cb4ed918939151a03f33d4242ccd0aa5f11b3547d0cf30f7c74a408a5b99878"}, - {file = "tomli-2.3.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:5192f562738228945d7b13d4930baffda67b69425a7f0da96d360b0a3888136b"}, - {file = "tomli-2.3.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:be71c93a63d738597996be9528f4abe628d1adf5e6eb11607bc8fe1a510b5dae"}, - {file = "tomli-2.3.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c4665508bcbac83a31ff8ab08f424b665200c0e1e645d2bd9ab3d3e557b6185b"}, - {file = "tomli-2.3.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4021923f97266babc6ccab9f5068642a0095faa0a51a246a6a02fccbb3514eaf"}, - {file = "tomli-2.3.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:a4ea38c40145a357d513bffad0ed869f13c1773716cf71ccaa83b0fa0cc4e42f"}, - {file = "tomli-2.3.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:ad805ea85eda330dbad64c7ea7a4556259665bdf9d2672f5dccc740eb9d3ca05"}, - {file = "tomli-2.3.0-cp313-cp313-win32.whl", hash = "sha256:97d5eec30149fd3294270e889b4234023f2c69747e555a27bd708828353ab606"}, - {file = "tomli-2.3.0-cp313-cp313-win_amd64.whl", hash = "sha256:0c95ca56fbe89e065c6ead5b593ee64b84a26fca063b5d71a1122bf26e533999"}, - {file = "tomli-2.3.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:cebc6fe843e0733ee827a282aca4999b596241195f43b4cc371d64fc6639da9e"}, - {file = "tomli-2.3.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4c2ef0244c75aba9355561272009d934953817c49f47d768070c3c94355c2aa3"}, - {file = "tomli-2.3.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c22a8bf253bacc0cf11f35ad9808b6cb75ada2631c2d97c971122583b129afbc"}, - {file = "tomli-2.3.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0eea8cc5c5e9f89c9b90c4896a8deefc74f518db5927d0e0e8d4a80953d774d0"}, - {file = "tomli-2.3.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:b74a0e59ec5d15127acdabd75ea17726ac4c5178ae51b85bfe39c4f8a278e879"}, - {file = "tomli-2.3.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:b5870b50c9db823c595983571d1296a6ff3e1b88f734a4c8f6fc6188397de005"}, - {file = "tomli-2.3.0-cp314-cp314-win32.whl", hash = "sha256:feb0dacc61170ed7ab602d3d972a58f14ee3ee60494292d384649a3dc38ef463"}, - {file = "tomli-2.3.0-cp314-cp314-win_amd64.whl", hash = "sha256:b273fcbd7fc64dc3600c098e39136522650c49bca95df2d11cf3b626422392c8"}, - {file = "tomli-2.3.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:940d56ee0410fa17ee1f12b817b37a4d4e4dc4d27340863cc67236c74f582e77"}, - {file = "tomli-2.3.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:f85209946d1fe94416debbb88d00eb92ce9cd5266775424ff81bc959e001acaf"}, - {file = "tomli-2.3.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a56212bdcce682e56b0aaf79e869ba5d15a6163f88d5451cbde388d48b13f530"}, - {file = "tomli-2.3.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c5f3ffd1e098dfc032d4d3af5c0ac64f6d286d98bc148698356847b80fa4de1b"}, - {file = "tomli-2.3.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5e01decd096b1530d97d5d85cb4dff4af2d8347bd35686654a004f8dea20fc67"}, - {file = "tomli-2.3.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:8a35dd0e643bb2610f156cca8db95d213a90015c11fee76c946aa62b7ae7e02f"}, - {file = "tomli-2.3.0-cp314-cp314t-win32.whl", hash = "sha256:a1f7f282fe248311650081faafa5f4732bdbfef5d45fe3f2e702fbc6f2d496e0"}, - {file = "tomli-2.3.0-cp314-cp314t-win_amd64.whl", hash = "sha256:70a251f8d4ba2d9ac2542eecf008b3c8a9fc5c3f9f02c56a9d7952612be2fdba"}, - {file = "tomli-2.3.0-py3-none-any.whl", hash = "sha256:e95b1af3c5b07d9e643909b5abbec77cd9f1217e6d0bca72b0234736b9fb1f1b"}, - {file = "tomli-2.3.0.tar.gz", hash = "sha256:64be704a875d2a59753d80ee8a533c3fe183e3f06807ff7dc2232938ccb01549"}, + {file = "tomli-2.4.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:f8f0fc26ec2cc2b965b7a3b87cd19c5c6b8c5e5f436b984e85f486d652285c30"}, + {file = "tomli-2.4.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:4ab97e64ccda8756376892c53a72bd1f964e519c77236368527f758fbc36a53a"}, + {file = "tomli-2.4.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96481a5786729fd470164b47cdb3e0e58062a496f455ee41b4403be77cb5a076"}, + {file = "tomli-2.4.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:5a881ab208c0baf688221f8cecc5401bd291d67e38a1ac884d6736cbcd8247e9"}, + {file = "tomli-2.4.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:47149d5bd38761ac8be13a84864bf0b7b70bc051806bc3669ab1cbc56216b23c"}, + {file = "tomli-2.4.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:ec9bfaf3ad2df51ace80688143a6a4ebc09a248f6ff781a9945e51937008fcbc"}, + {file = "tomli-2.4.1-cp311-cp311-win32.whl", hash = "sha256:ff2983983d34813c1aeb0fa89091e76c3a22889ee83ab27c5eeb45100560c049"}, + {file = "tomli-2.4.1-cp311-cp311-win_amd64.whl", hash = "sha256:5ee18d9ebdb417e384b58fe414e8d6af9f4e7a0ae761519fb50f721de398dd4e"}, + {file = "tomli-2.4.1-cp311-cp311-win_arm64.whl", hash = "sha256:c2541745709bad0264b7d4705ad453b76ccd191e64aa6f0fc66b69a293a45ece"}, + {file = "tomli-2.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:c742f741d58a28940ce01d58f0ab2ea3ced8b12402f162f4d534dfe18ba1cd6a"}, + {file = "tomli-2.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:7f86fd587c4ed9dd76f318225e7d9b29cfc5a9d43de44e5754db8d1128487085"}, + {file = "tomli-2.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ff18e6a727ee0ab0388507b89d1bc6a22b138d1e2fa56d1ad494586d61d2eae9"}, + {file = "tomli-2.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:136443dbd7e1dee43c68ac2694fde36b2849865fa258d39bf822c10e8068eac5"}, + {file = "tomli-2.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:5e262d41726bc187e69af7825504c933b6794dc3fbd5945e41a79bb14c31f585"}, + {file = "tomli-2.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:5cb41aa38891e073ee49d55fbc7839cfdb2bc0e600add13874d048c94aadddd1"}, + {file = "tomli-2.4.1-cp312-cp312-win32.whl", hash = "sha256:da25dc3563bff5965356133435b757a795a17b17d01dbc0f42fb32447ddfd917"}, + {file = "tomli-2.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:52c8ef851d9a240f11a88c003eacb03c31fc1c9c4ec64a99a0f922b93874fda9"}, + {file = "tomli-2.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:f758f1b9299d059cc3f6546ae2af89670cb1c4d48ea29c3cacc4fe7de3058257"}, + {file = "tomli-2.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:36d2bd2ad5fb9eaddba5226aa02c8ec3fa4f192631e347b3ed28186d43be6b54"}, + {file = "tomli-2.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:eb0dc4e38e6a1fd579e5d50369aa2e10acfc9cace504579b2faabb478e76941a"}, + {file = "tomli-2.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c7f2c7f2b9ca6bdeef8f0fa897f8e05085923eb091721675170254cbc5b02897"}, + {file = "tomli-2.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3c6818a1a86dd6dca7ddcaaf76947d5ba31aecc28cb1b67009a5877c9a64f3f"}, + {file = "tomli-2.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:d312ef37c91508b0ab2cee7da26ec0b3ed2f03ce12bd87a588d771ae15dcf82d"}, + {file = "tomli-2.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:51529d40e3ca50046d7606fa99ce3956a617f9b36380da3b7f0dd3dd28e68cb5"}, + {file = "tomli-2.4.1-cp313-cp313-win32.whl", hash = "sha256:2190f2e9dd7508d2a90ded5ed369255980a1bcdd58e52f7fe24b8162bf9fedbd"}, + {file = "tomli-2.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:8d65a2fbf9d2f8352685bc1364177ee3923d6baf5e7f43ea4959d7d8bc326a36"}, + {file = "tomli-2.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:4b605484e43cdc43f0954ddae319fb75f04cc10dd80d830540060ee7cd0243cd"}, + {file = "tomli-2.4.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:fd0409a3653af6c147209d267a0e4243f0ae46b011aa978b1080359fddc9b6cf"}, + {file = "tomli-2.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:a120733b01c45e9a0c34aeef92bf0cf1d56cfe81ed9d47d562f9ed591a9828ac"}, + {file = "tomli-2.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:559db847dc486944896521f68d8190be1c9e719fced785720d2216fe7022b662"}, + {file = "tomli-2.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:01f520d4f53ef97964a240a035ec2a869fe1a37dde002b57ebc4417a27ccd853"}, + {file = "tomli-2.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7f94b27a62cfad8496c8d2513e1a222dd446f095fca8987fceef261225538a15"}, + {file = "tomli-2.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:ede3e6487c5ef5d28634ba3f31f989030ad6af71edfb0055cbbd14189ff240ba"}, + {file = "tomli-2.4.1-cp314-cp314-win32.whl", hash = "sha256:3d48a93ee1c9b79c04bb38772ee1b64dcf18ff43085896ea460ca8dec96f35f6"}, + {file = "tomli-2.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:88dceee75c2c63af144e456745e10101eb67361050196b0b6af5d717254dddf7"}, + {file = "tomli-2.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:b8c198f8c1805dc42708689ed6864951fd2494f924149d3e4bce7710f8eb5232"}, + {file = "tomli-2.4.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:d4d8fe59808a54658fcc0160ecfb1b30f9089906c50b23bcb4c69eddc19ec2b4"}, + {file = "tomli-2.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:7008df2e7655c495dd12d2a4ad038ff878d4ca4b81fccaf82b714e07eae4402c"}, + {file = "tomli-2.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1d8591993e228b0c930c4bb0db464bdad97b3289fb981255d6c9a41aedc84b2d"}, + {file = "tomli-2.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:734e20b57ba95624ecf1841e72b53f6e186355e216e5412de414e3c51e5e3c41"}, + {file = "tomli-2.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8a650c2dbafa08d42e51ba0b62740dae4ecb9338eefa093aa5c78ceb546fcd5c"}, + {file = "tomli-2.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:504aa796fe0569bb43171066009ead363de03675276d2d121ac1a4572397870f"}, + {file = "tomli-2.4.1-cp314-cp314t-win32.whl", hash = "sha256:b1d22e6e9387bf4739fbe23bfa80e93f6b0373a7f1b96c6227c32bef95a4d7a8"}, + {file = "tomli-2.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:2c1c351919aca02858f740c6d33adea0c5deea37f9ecca1cc1ef9e884a619d26"}, + {file = "tomli-2.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:eab21f45c7f66c13f2a9e0e1535309cee140182a9cdae1e041d02e47291e8396"}, + {file = "tomli-2.4.1-py3-none-any.whl", hash = "sha256:0d85819802132122da43cb86656f8d1f8c6587d54ae7dcaf30e90533028b49fe"}, + {file = "tomli-2.4.1.tar.gz", hash = "sha256:7c7e1a961a0b2f2472c1ac5b69affa0ae1132c39adcb67aba98568702b9cc23f"}, ] [[package]] @@ -1988,14 +2050,14 @@ typing-extensions = ">=4.12.0" [[package]] name = "urllib3" -version = "2.6.2" +version = "2.6.3" description = "HTTP library with thread-safe connection pooling, file post, and more." optional = false python-versions = ">=3.9" groups = ["main", "dev"] files = [ - {file = "urllib3-2.6.2-py3-none-any.whl", hash = "sha256:ec21cddfe7724fc7cb4ba4bea7aa8e2ef36f607a4bab81aa6ce42a13dc3f03dd"}, - {file = "urllib3-2.6.2.tar.gz", hash = "sha256:016f9c98bb7e98085cb2b4b17b87d2c702975664e4f060c6532e64d1c1a5e797"}, + {file = "urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4"}, + {file = "urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed"}, ] [package.extras] @@ -2006,14 +2068,14 @@ zstd = ["backports-zstd (>=1.0.0) ; python_version < \"3.14\""] [[package]] name = "wcwidth" -version = "0.2.14" +version = "0.6.0" description = "Measures the displayed width of unicode strings in a terminal" optional = false -python-versions = ">=3.6" +python-versions = ">=3.8" groups = ["dev"] files = [ - {file = "wcwidth-0.2.14-py2.py3-none-any.whl", hash = "sha256:a7bb560c8aee30f9957e5f9895805edd20602f2d7f720186dfd906e82b4982e1"}, - {file = "wcwidth-0.2.14.tar.gz", hash = "sha256:4d478375d31bc5395a3c55c40ccdf3354688364cd61c4f6adacaa9215d0b3605"}, + {file = "wcwidth-0.6.0-py3-none-any.whl", hash = "sha256:1a3a1e510b553315f8e146c54764f4fb6264ffad731b3d78088cdb1478ffbdad"}, + {file = "wcwidth-0.6.0.tar.gz", hash = "sha256:cdc4e4262d6ef9a1a57e018384cbeb1208d8abbc64176027e2c2455c81313159"}, ] [[package]] From a14d6beb86f3e72a2b1662b1f44380663ee01def Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Wed, 13 May 2026 15:48:50 +0000 Subject: [PATCH 45/55] Bump protobufjs from 7.5.5 to 7.5.8 Bumps [protobufjs](https://github.com/protobufjs/protobuf.js) from 7.5.5 to 7.5.8. - [Release notes](https://github.com/protobufjs/protobuf.js/releases) - [Changelog](https://github.com/protobufjs/protobuf.js/blob/protobufjs-v7.5.8/CHANGELOG.md) - [Commits](https://github.com/protobufjs/protobuf.js/compare/protobufjs-v7.5.5...protobufjs-v7.5.8) --- updated-dependencies: - dependency-name: protobufjs dependency-version: 7.5.8 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- package-lock.json | 63 ++++++++++++++++++++++------------------------- 1 file changed, 30 insertions(+), 33 deletions(-) diff --git a/package-lock.json b/package-lock.json index 42c861ade..46ad9f502 100644 --- a/package-lock.json +++ b/package-lock.json @@ -326,10 +326,9 @@ "license": "BSD-3-Clause" }, "node_modules/@protobufjs/codegen": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.4.tgz", - "integrity": "sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==", - "license": "BSD-3-Clause" + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.5.tgz", + "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==" }, "node_modules/@protobufjs/eventemitter": { "version": "1.1.0", @@ -354,10 +353,9 @@ "license": "BSD-3-Clause" }, "node_modules/@protobufjs/inquire": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.0.tgz", - "integrity": "sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==", - "license": "BSD-3-Clause" + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.1.tgz", + "integrity": "sha512-mnzgDV26ueAvk7rsbt9L7bE0SuAoqyuys/sMMrmVcN5x9VsxpcG3rqAUSgDyLp0UZlmNfIbQ4fHfCtreVBk8Ew==" }, "node_modules/@protobufjs/path": { "version": "1.1.2", @@ -372,10 +370,9 @@ "license": "BSD-3-Clause" }, "node_modules/@protobufjs/utf8": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.0.tgz", - "integrity": "sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==", - "license": "BSD-3-Clause" + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.1.tgz", + "integrity": "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg==" }, "node_modules/@redocly/ajv": { "version": "8.18.1", @@ -1928,21 +1925,21 @@ } }, "node_modules/protobufjs": { - "version": "7.5.5", - "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.5.tgz", - "integrity": "sha512-3wY1AxV+VBNW8Yypfd1yQY9pXnqTAN+KwQxL8iYm3/BjKYMNg4i0owhEe26PWDOMaIrzeeF98Lqd5NGz4omiIg==", + "version": "7.5.8", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.8.tgz", + "integrity": "sha512-dvpCIeLPbXZS/Ete7yLaO7RenOdken2NHKykBXbsaGxZT0UTltcarBciw+A78SRQs9iMAAVpsYA+l8b1hTePIA==", "hasInstallScript": true, "dependencies": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", - "@protobufjs/codegen": "^2.0.4", + "@protobufjs/codegen": "^2.0.5", "@protobufjs/eventemitter": "^1.1.0", "@protobufjs/fetch": "^1.1.0", "@protobufjs/float": "^1.0.2", - "@protobufjs/inquire": "^1.1.0", + "@protobufjs/inquire": "^1.1.1", "@protobufjs/path": "^1.1.2", "@protobufjs/pool": "^1.1.0", - "@protobufjs/utf8": "^1.1.0", + "@protobufjs/utf8": "^1.1.1", "@types/node": ">=13.7.0", "long": "^5.0.0" }, @@ -3028,9 +3025,9 @@ "integrity": "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==" }, "@protobufjs/codegen": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.4.tgz", - "integrity": "sha512-YyFaikqM5sH0ziFZCN3xDC7zeGaB/d0IUb9CATugHWbd1FRFwWwt4ld4OYMPWu5a3Xe01mGAULCdqhMlPl29Jg==" + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.5.tgz", + "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==" }, "@protobufjs/eventemitter": { "version": "1.1.0", @@ -3052,9 +3049,9 @@ "integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==" }, "@protobufjs/inquire": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.0.tgz", - "integrity": "sha512-kdSefcPdruJiFMVSbn801t4vFK7KB/5gd2fYvrxhuJYg8ILrmn9SKSX2tZdV6V+ksulWqS7aXjBcRXl3wHoD9Q==" + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.1.tgz", + "integrity": "sha512-mnzgDV26ueAvk7rsbt9L7bE0SuAoqyuys/sMMrmVcN5x9VsxpcG3rqAUSgDyLp0UZlmNfIbQ4fHfCtreVBk8Ew==" }, "@protobufjs/path": { "version": "1.1.2", @@ -3067,9 +3064,9 @@ "integrity": "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==" }, "@protobufjs/utf8": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.0.tgz", - "integrity": "sha512-Vvn3zZrhQZkkBE8LSuW3em98c0FwgO4nxzv6OdSxPKJIEKY2bGbHn+mhGIPerzI4twdxaP8/0+06HBpwf345Lw==" + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.1.tgz", + "integrity": "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg==" }, "@redocly/ajv": { "version": "8.18.1", @@ -4141,20 +4138,20 @@ } }, "protobufjs": { - "version": "7.5.5", - "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.5.tgz", - "integrity": "sha512-3wY1AxV+VBNW8Yypfd1yQY9pXnqTAN+KwQxL8iYm3/BjKYMNg4i0owhEe26PWDOMaIrzeeF98Lqd5NGz4omiIg==", + "version": "7.5.8", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.8.tgz", + "integrity": "sha512-dvpCIeLPbXZS/Ete7yLaO7RenOdken2NHKykBXbsaGxZT0UTltcarBciw+A78SRQs9iMAAVpsYA+l8b1hTePIA==", "requires": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", - "@protobufjs/codegen": "^2.0.4", + "@protobufjs/codegen": "^2.0.5", "@protobufjs/eventemitter": "^1.1.0", "@protobufjs/fetch": "^1.1.0", "@protobufjs/float": "^1.0.2", - "@protobufjs/inquire": "^1.1.0", + "@protobufjs/inquire": "^1.1.1", "@protobufjs/path": "^1.1.2", "@protobufjs/pool": "^1.1.0", - "@protobufjs/utf8": "^1.1.0", + "@protobufjs/utf8": "^1.1.1", "@types/node": ">=13.7.0", "long": "^5.0.0" } From 8841780edf1fde389ecb0e4442a2ed2878704b0d Mon Sep 17 00:00:00 2001 From: "dependabot[bot]" <49699333+dependabot[bot]@users.noreply.github.com> Date: Thu, 23 Apr 2026 15:51:19 +0000 Subject: [PATCH 46/55] Bump @hapi/content from 6.0.0 to 6.0.1 in /sandbox Bumps [@hapi/content](https://github.com/hapijs/content) from 6.0.0 to 6.0.1. - [Commits](https://github.com/hapijs/content/compare/v6.0.0...v6.0.1) --- updated-dependencies: - dependency-name: "@hapi/content" dependency-version: 6.0.1 dependency-type: indirect ... Signed-off-by: dependabot[bot] --- sandbox/package-lock.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index 84628f4d3..c230c76a0 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -261,9 +261,9 @@ } }, "node_modules/@hapi/content": { - "version": "6.0.0", - "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.0.tgz", - "integrity": "sha512-CEhs7j+H0iQffKfe5Htdak5LBOz/Qc8TRh51cF+BFv0qnuph3Em4pjGVzJMkI2gfTDdlJKWJISGWS1rK34POGA==", + "version": "6.0.1", + "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.1.tgz", + "integrity": "sha512-lQ2vOoFMNYxwKVnKf+3Pi3PfoviM4EJYlT9JbrBPfEc0xKMiVDqqXF8UTE1S1oKhHQliWSP5t6zTKNlmaXBGcQ==", "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.0" From 9817ee7bc8c162deaae586b0948b735a9e4f6105 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Mon, 18 May 2026 13:12:50 +0000 Subject: [PATCH 47/55] [RAA-7531]-[GC]-[Bump dependencies]-[EW] --- package-lock.json | 3058 +++++++------------------------------ poetry.lock | 62 +- sandbox/package-lock.json | 102 +- 3 files changed, 650 insertions(+), 2572 deletions(-) diff --git a/package-lock.json b/package-lock.json index 46ad9f502..286c33ca3 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,7 +1,7 @@ { "name": "e-referrals-service-api", "version": "0.0.1", - "lockfileVersion": 2, + "lockfileVersion": 3, "requires": true, "packages": { "": { @@ -63,12 +63,6 @@ "integrity": "sha512-30FAj7/EoJ5mwVPOWhAyCX+FPfMDrVecJAM+Iw9NRoSl4BBAQeqj4cApHHUXOVvIPgLVDsCFoz/hGD+5QQD1GQ==", "license": "MIT" }, - "node_modules/@emotion/unitless": { - "version": "0.10.0", - "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.10.0.tgz", - "integrity": "sha512-dFoMUuQA20zvtVTuxZww6OHoJYgrzfKM1t52mVySDJnMSEa08ruEvdYQbhvyu6soU+NeLVd3yKfTfT0NeV6qGg==", - "license": "MIT" - }, "node_modules/@exodus/schemasafe": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/@exodus/schemasafe/-/schemasafe-1.3.0.tgz", @@ -115,7 +109,8 @@ "type": "github", "url": "https://github.com/sponsors/nodable" } - ] + ], + "license": "MIT" }, "node_modules/@opentelemetry/api": { "version": "1.9.1", @@ -127,9 +122,9 @@ } }, "node_modules/@opentelemetry/api-logs": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.202.0.tgz", - "integrity": "sha512-fTBjMqKCfotFWfLzaKyhjLvyEyq5vDKTTFfBmx21btv3gvy8Lq6N5Dh2OzqeuN4DjtpSvNT1uNVfg08eD2Rfxw==", + "version": "0.214.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.214.0.tgz", + "integrity": "sha512-40lSJeqYO8Uz2Yj7u94/SJWE/wONa7rmMKjI1ZcIjgf3MHNHv1OZUCrCETGuaRF62d5pQD1wKIW+L4lmSMTzZA==", "license": "Apache-2.0", "dependencies": { "@opentelemetry/api": "^1.3.0" @@ -139,9 +134,9 @@ } }, "node_modules/@opentelemetry/context-async-hooks": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-2.0.1.tgz", - "integrity": "sha512-XuY23lSI3d4PEqKA+7SLtAgwqIfc6E/E9eAQWLN1vlpC53ybO3o6jW4BsXo1xvz9lYyyWItfQDDLzezER01mCw==", + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-2.6.1.tgz", + "integrity": "sha512-XHzhwRNkBpeP8Fs/qjGrAf9r9PRv67wkJQ/7ZPaBQQ68DYlTBBx5MF9LvPx7mhuXcDessKK2b+DcxqwpgkcivQ==", "license": "Apache-2.0", "engines": { "node": "^18.19.0 || >=20.6.0" @@ -151,9 +146,9 @@ } }, "node_modules/@opentelemetry/core": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", - "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.6.1.tgz", + "integrity": "sha512-8xHSGWpJP9wBxgBpnqGL0R3PbdWQndL1Qp50qrg71+B28zK5OQmUgcDKLJgzyAAV38t4tOyLMGDD60LneR5W8g==", "license": "Apache-2.0", "dependencies": { "@opentelemetry/semantic-conventions": "^1.29.0" @@ -166,16 +161,16 @@ } }, "node_modules/@opentelemetry/exporter-trace-otlp-http": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.202.0.tgz", - "integrity": "sha512-/hKE8DaFCJuaQqE1IxpgkcjOolUIwgi3TgHElPVKGdGRBSmJMTmN/cr6vWa55pCJIXPyhKvcMrbrya7DZ3VmzA==", + "version": "0.214.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.214.0.tgz", + "integrity": "sha512-kIN8nTBMgV2hXzV/a20BCFilPZdAIMYYJGSgfMMRm/Xa+07y5hRDS2Vm12A/z8Cdu3Sq++ZvJfElokX2rkgGgw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/otlp-exporter-base": "0.202.0", - "@opentelemetry/otlp-transformer": "0.202.0", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/sdk-trace-base": "2.0.1" + "@opentelemetry/core": "2.6.1", + "@opentelemetry/otlp-exporter-base": "0.214.0", + "@opentelemetry/otlp-transformer": "0.214.0", + "@opentelemetry/resources": "2.6.1", + "@opentelemetry/sdk-trace-base": "2.6.1" }, "engines": { "node": "^18.19.0 || >=20.6.0" @@ -185,13 +180,13 @@ } }, "node_modules/@opentelemetry/otlp-exporter-base": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.202.0.tgz", - "integrity": "sha512-nMEOzel+pUFYuBJg2znGmHJWbmvMbdX5/RhoKNKowguMbURhz0fwik5tUKplLcUtl8wKPL1y9zPnPxeBn65N0Q==", + "version": "0.214.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.214.0.tgz", + "integrity": "sha512-u1Gdv0/E9wP+apqWf7Wv2npXmgJtxsW2XL0TEv9FZloTZRuMBKmu8cYVXwS4Hm3q/f/3FuCnPTgiwYvIqRSpRg==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/otlp-transformer": "0.202.0" + "@opentelemetry/core": "2.6.1", + "@opentelemetry/otlp-transformer": "0.214.0" }, "engines": { "node": "^18.19.0 || >=20.6.0" @@ -201,18 +196,18 @@ } }, "node_modules/@opentelemetry/otlp-transformer": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.202.0.tgz", - "integrity": "sha512-5XO77QFzs9WkexvJQL9ksxL8oVFb/dfi9NWQSq7Sv0Efr9x3N+nb1iklP1TeVgxqJ7m1xWiC/Uv3wupiQGevMw==", + "version": "0.214.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.214.0.tgz", + "integrity": "sha512-DSaYcuBRh6uozfsWN3R8HsN0yDhCuWP7tOFdkUOVaWD1KVJg8m4qiLUsg/tNhTLS9HUYUcwNpwL2eroLtsZZ/w==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/api-logs": "0.202.0", - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/sdk-logs": "0.202.0", - "@opentelemetry/sdk-metrics": "2.0.1", - "@opentelemetry/sdk-trace-base": "2.0.1", - "protobufjs": "^7.3.0" + "@opentelemetry/api-logs": "0.214.0", + "@opentelemetry/core": "2.6.1", + "@opentelemetry/resources": "2.6.1", + "@opentelemetry/sdk-logs": "0.214.0", + "@opentelemetry/sdk-metrics": "2.6.1", + "@opentelemetry/sdk-trace-base": "2.6.1", + "protobufjs": "^7.0.0" }, "engines": { "node": "^18.19.0 || >=20.6.0" @@ -222,12 +217,12 @@ } }, "node_modules/@opentelemetry/resources": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", - "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.6.1.tgz", + "integrity": "sha512-lID/vxSuKWXM55XhAKNoYXu9Cutoq5hFdkbTdI/zDKQktXzcWBVhNsOkiZFTMU9UtEWuGRNe0HUgmsFldIdxVA==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "2.0.1", + "@opentelemetry/core": "2.6.1", "@opentelemetry/semantic-conventions": "^1.29.0" }, "engines": { @@ -238,14 +233,15 @@ } }, "node_modules/@opentelemetry/sdk-logs": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.202.0.tgz", - "integrity": "sha512-pv8QiQLQzk4X909YKm0lnW4hpuQg4zHwJ4XBd5bZiXcd9urvrJNoNVKnxGHPiDVX/GiLFvr5DMYsDBQbZCypRQ==", + "version": "0.214.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.214.0.tgz", + "integrity": "sha512-zf6acnScjhsaBUU22zXZ/sLWim1dfhUAbGXdMmHmNG3LfBnQ3DKsOCITb2IZwoUsNNMTogqFKBnlIPPftUgGwA==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/api-logs": "0.202.0", - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1" + "@opentelemetry/api-logs": "0.214.0", + "@opentelemetry/core": "2.6.1", + "@opentelemetry/resources": "2.6.1", + "@opentelemetry/semantic-conventions": "^1.29.0" }, "engines": { "node": "^18.19.0 || >=20.6.0" @@ -255,13 +251,13 @@ } }, "node_modules/@opentelemetry/sdk-metrics": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-2.0.1.tgz", - "integrity": "sha512-wf8OaJoSnujMAHWR3g+/hGvNcsC16rf9s1So4JlMiFaFHiE4HpIA3oUh+uWZQ7CNuK8gVW/pQSkgoa5HkkOl0g==", + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-2.6.1.tgz", + "integrity": "sha512-9t9hJHX15meBy2NmTJxL+NJfXmnausR2xUDvE19XQce0Qi/GBtDGamU8nS1RMbdgDmhgpm3VaOu2+fiS/SfTpQ==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1" + "@opentelemetry/core": "2.6.1", + "@opentelemetry/resources": "2.6.1" }, "engines": { "node": "^18.19.0 || >=20.6.0" @@ -271,13 +267,13 @@ } }, "node_modules/@opentelemetry/sdk-trace-base": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", - "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.6.1.tgz", + "integrity": "sha512-r86ut4T1e8vNwB35CqCcKd45yzqH6/6Wzvpk2/cZB8PsPLlZFTvrh8yfOS3CYZYcUmAx4hHTZJ8AO8Dj8nrdhw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1", + "@opentelemetry/core": "2.6.1", + "@opentelemetry/resources": "2.6.1", "@opentelemetry/semantic-conventions": "^1.29.0" }, "engines": { @@ -288,14 +284,14 @@ } }, "node_modules/@opentelemetry/sdk-trace-node": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-2.0.1.tgz", - "integrity": "sha512-UhdbPF19pMpBtCWYP5lHbTogLWx9N0EBxtdagvkn5YtsAnCBZzL7SjktG+ZmupRgifsHMjwUaCCaVmqGfSADmA==", + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-2.6.1.tgz", + "integrity": "sha512-Hh2i4FwHWRFhnO2Q/p6svMxy8MPsNCG0uuzUY3glqm0rwM0nQvbTO1dXSp9OqQoTKXcQzaz9q1f65fsurmOhNw==", "license": "Apache-2.0", "dependencies": { - "@opentelemetry/context-async-hooks": "2.0.1", - "@opentelemetry/core": "2.0.1", - "@opentelemetry/sdk-trace-base": "2.0.1" + "@opentelemetry/context-async-hooks": "2.6.1", + "@opentelemetry/core": "2.6.1", + "@opentelemetry/sdk-trace-base": "2.6.1" }, "engines": { "node": "^18.19.0 || >=20.6.0" @@ -305,9 +301,9 @@ } }, "node_modules/@opentelemetry/semantic-conventions": { - "version": "1.34.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.34.0.tgz", - "integrity": "sha512-aKcOkyrorBGlajjRdVoJWHTxfxO1vCNHLJVlSDaRHDIdjU+pX8IYQPvPDkYiujKLbRnWU+1TBwEt0QRgSm4SGA==", + "version": "1.40.0", + "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.40.0.tgz", + "integrity": "sha512-cifvXDhcqMwwTlTK04GBNeIe7yyo28Mfby85QXFe1Yk8nmi36Ab/5UQwptOx84SsoGNRg+EVSjwzfSZMy6pmlw==", "license": "Apache-2.0", "engines": { "node": ">=14" @@ -328,7 +324,8 @@ "node_modules/@protobufjs/codegen": { "version": "2.0.5", "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.5.tgz", - "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==" + "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==", + "license": "BSD-3-Clause" }, "node_modules/@protobufjs/eventemitter": { "version": "1.1.0", @@ -337,13 +334,12 @@ "license": "BSD-3-Clause" }, "node_modules/@protobufjs/fetch": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.0.tgz", - "integrity": "sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==", + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.1.tgz", + "integrity": "sha512-GpptLrs57adMSuHi3VNj0mAF8dwh36LMaYF6XyJ6JMWlVsc+t42tm1HSEDmOs3A8fC9yyeisgLhsTVQokOZ0zw==", "license": "BSD-3-Clause", "dependencies": { - "@protobufjs/aspromise": "^1.1.1", - "@protobufjs/inquire": "^1.1.0" + "@protobufjs/aspromise": "^1.1.1" } }, "node_modules/@protobufjs/float": { @@ -353,9 +349,10 @@ "license": "BSD-3-Clause" }, "node_modules/@protobufjs/inquire": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.1.tgz", - "integrity": "sha512-mnzgDV26ueAvk7rsbt9L7bE0SuAoqyuys/sMMrmVcN5x9VsxpcG3rqAUSgDyLp0UZlmNfIbQ4fHfCtreVBk8Ew==" + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.2.tgz", + "integrity": "sha512-pa0vFRuws4wkvaXKK1uXZMAwAX4/t8ANaJo45iw/oQHNQ9q5xUzwgFmVJGXiga2BeN+zpX7Vf9vmsiIa2J+MUw==", + "license": "BSD-3-Clause" }, "node_modules/@protobufjs/path": { "version": "1.1.2", @@ -372,12 +369,13 @@ "node_modules/@protobufjs/utf8": { "version": "1.1.1", "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.1.tgz", - "integrity": "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg==" + "integrity": "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg==", + "license": "BSD-3-Clause" }, "node_modules/@redocly/ajv": { - "version": "8.18.1", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.1.tgz", - "integrity": "sha512-Ifm/pP/tul1qmAecpbVxCBluVE32rKfjf8gYXH4xI2gCv9mRWFhJMHzkPDM4TXlxwPQYIFegymlsy8lXz7optA==", + "version": "8.18.3", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.3.tgz", + "integrity": "sha512-l42u0of3hY98sN2A+M4qTX1O/KrpgGH32Hu9kP2GtHyD5Dfqq86PKFLe5dwaD8DEnNmlOlll2BAmeEtf0DaySg==", "license": "MIT", "dependencies": { "fast-deep-equal": "^3.1.3", @@ -391,26 +389,25 @@ } }, "node_modules/@redocly/cli": { - "version": "2.25.3", - "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-2.25.3.tgz", - "integrity": "sha512-02wjApwJwGD+kGWRoiFVY0Hq960ydMAMHrK3AJH2LMiYNYcrzAr1FSbA3OSylvg2gx3w/r1r710B+iMz3KJKbw==", + "version": "2.31.0", + "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-2.31.0.tgz", + "integrity": "sha512-wurF8qBQHNlqxkiey6P6HGdn7TcpsXa6r/Vs7AuqUgge5kdYEfNE9fYvL1pSAT+AduwOBRtWnijvMmJX8QtmUw==", "license": "MIT", "dependencies": { - "@opentelemetry/exporter-trace-otlp-http": "0.202.0", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/sdk-trace-node": "2.0.1", - "@opentelemetry/semantic-conventions": "1.34.0", + "@opentelemetry/exporter-trace-otlp-http": "0.214.0", + "@opentelemetry/resources": "2.6.1", + "@opentelemetry/sdk-trace-node": "2.6.1", + "@opentelemetry/semantic-conventions": "1.40.0", "@redocly/cli-otel": "0.1.2", - "@redocly/openapi-core": "2.25.3", - "@redocly/respect-core": "2.25.3", - "abort-controller": "^3.0.0", - "ajv": "npm:@redocly/ajv@8.18.0", + "@redocly/openapi-core": "2.31.0", + "@redocly/respect-core": "2.31.0", + "ajv": "npm:@redocly/ajv@8.18.1", "ajv-formats": "^3.0.1", "colorette": "^1.2.0", "cookie": "^0.7.2", "dotenv": "16.4.7", "glob": "^13.0.5", - "handlebars": "^4.7.6", + "handlebars": "^4.7.9", "https-proxy-agent": "^7.0.5", "mobx": "^6.0.4", "picomatch": "^4.0.4", @@ -421,7 +418,7 @@ "semver": "^7.5.2", "set-cookie-parser": "^2.3.5", "simple-websocket": "^9.0.0", - "styled-components": "6.3.9", + "styled-components": "6.4.1", "ulid": "^3.0.1", "undici": "6.24.0", "yargs": "17.0.1" @@ -453,88 +450,24 @@ "ulid": "bin/cli.js" } }, - "node_modules/@redocly/cli/node_modules/balanced-match": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", - "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", - "license": "MIT", - "engines": { - "node": "18 || 20 || >=22" - } - }, - "node_modules/@redocly/cli/node_modules/brace-expansion": { - "version": "5.0.5", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz", - "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==", - "license": "MIT", - "dependencies": { - "balanced-match": "^4.0.2" - }, - "engines": { - "node": "18 || 20 || >=22" - } - }, - "node_modules/@redocly/cli/node_modules/glob": { - "version": "13.0.6", - "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz", - "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", - "license": "BlueOak-1.0.0", - "dependencies": { - "minimatch": "^10.2.2", - "minipass": "^7.1.3", - "path-scurry": "^2.0.2" - }, - "engines": { - "node": "18 || 20 || >=22" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/@redocly/cli/node_modules/minimatch": { - "version": "10.2.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", - "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", - "dependencies": { - "brace-expansion": "^5.0.5" - }, - "engines": { - "node": "18 || 20 || >=22" - }, - "funding": { - "url": "https://github.com/sponsors/isaacs" - } - }, - "node_modules/@redocly/cli/node_modules/semver": { - "version": "7.7.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", - "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==", - "license": "ISC", - "bin": { - "semver": "bin/semver.js" - }, - "engines": { - "node": ">=10" - } - }, "node_modules/@redocly/config": { - "version": "0.45.0", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.45.0.tgz", - "integrity": "sha512-V+wNusPQUaYV1c5s9iptfKQ2Ggno4bMeiyXdNILxqZS87gttwPfqlqHKHKFyz006voS3JsR295cbpx3GlsIxKg==", + "version": "0.48.2", + "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.48.2.tgz", + "integrity": "sha512-DUHthTRdj+caAQWCtJae4yzvxaUDuwQkFsZFVaAEyORd8Bt8K2wYso61jYZuR/kQZaDejfUREtQTVVZ5VYTqgw==", "license": "MIT", "dependencies": { "json-schema-to-ts": "2.7.2" } }, "node_modules/@redocly/openapi-core": { - "version": "2.25.3", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.25.3.tgz", - "integrity": "sha512-GIu3Mdym5IDIPCvXTzMZ6TQw/+7sKd52PdysxNVe7zBk22ExSGnVE9UAk9BaLOzXT77PJWDUwaimBdJoPpxHMA==", + "version": "2.31.0", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.31.0.tgz", + "integrity": "sha512-V9HCKZlSzAcRXiB8Oe8qjkwrEpzkq4n5k2McANZN7mzVDN/BM4YIcsJrwJ5Q4OWUlWASnAb1cSSRau45+eAqfw==", "license": "MIT", "dependencies": { - "@redocly/ajv": "^8.18.0", - "@redocly/config": "^0.45.0", - "ajv": "npm:@redocly/ajv@8.18.0", + "@redocly/ajv": "^8.18.1", + "@redocly/config": "^0.48.1", + "ajv": "npm:@redocly/ajv@8.18.1", "ajv-formats": "^3.0.1", "colorette": "^1.2.0", "js-levenshtein": "^1.1.6", @@ -549,17 +482,17 @@ } }, "node_modules/@redocly/respect-core": { - "version": "2.25.3", - "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.25.3.tgz", - "integrity": "sha512-07m80JYdp7J7kH4D1Vqdpa2ZBFCv3QAwCoh2w9H3OjuT/rXQkBSkJQm1n70fzO/HuUf4azzULdp2XnsIpxP2qw==", + "version": "2.31.0", + "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.31.0.tgz", + "integrity": "sha512-062sRStAzfmtdxJgpDcrAZyANlSE0p5eEvTNzPTwJpb1wXP38prA4SVDS8A+d5733gAa7BjiEiGOTF2Pg33YWQ==", "license": "MIT", "dependencies": { "@faker-js/faker": "^7.6.0", "@noble/hashes": "^1.8.0", - "@redocly/ajv": "^8.18.0", - "@redocly/openapi-core": "2.25.3", - "ajv": "npm:@redocly/ajv@8.18.0", - "better-ajv-errors": "^1.2.0", + "@redocly/ajv": "^8.18.1", + "@redocly/openapi-core": "2.31.0", + "ajv": "npm:@redocly/ajv@8.18.1", + "better-ajv-errors": "^2.0.3", "colorette": "^2.0.20", "json-pointer": "^0.6.2", "jsonpath-rfc9535": "1.3.0", @@ -585,20 +518,14 @@ "license": "MIT" }, "node_modules/@types/node": { - "version": "25.5.0", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.5.0.tgz", - "integrity": "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw==", + "version": "25.9.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-25.9.0.tgz", + "integrity": "sha512-AOQwYUNolgy3VosiRqXrACUXTN8nJUtPl7FJXMqZVyxiiCLhQuG3jXKvCS1ALr+Y2OmZhzzLVlYPEqJaiqkaJQ==", "license": "MIT", "dependencies": { - "undici-types": "~7.18.0" + "undici-types": ">=7.24.0 <7.24.7" } }, - "node_modules/@types/stylis": { - "version": "4.2.7", - "resolved": "https://registry.npmjs.org/@types/stylis/-/stylis-4.2.7.tgz", - "integrity": "sha512-VgDNokpBoKF+wrdvhAAfS55OMQpL6QRglwTwNC3kIgBrzZxA4WsFj+2eLfEA/uMUDzBcEhYmjSbwQakn/i3ajA==", - "license": "MIT" - }, "node_modules/@types/trusted-types": { "version": "2.0.7", "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz", @@ -610,18 +537,8 @@ "version": "1.1.1", "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz", "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q==", - "dev": true - }, - "node_modules/abort-controller": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz", - "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==", - "dependencies": { - "event-target-shim": "^5.0.0" - }, - "engines": { - "node": ">=6.5" - } + "dev": true, + "license": "ISC" }, "node_modules/agent-base": { "version": "7.1.4", @@ -634,9 +551,9 @@ }, "node_modules/ajv": { "name": "@redocly/ajv", - "version": "8.18.0", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.0.tgz", - "integrity": "sha512-F+LMD2IDIXuHxgpLJh3nkLj9+tSaEzoUWd+7fONGq5pe2169FUDjpEkOfEpoGLz1sbZni/69p07OsecNfAOpqA==", + "version": "8.18.1", + "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.1.tgz", + "integrity": "sha512-Ifm/pP/tul1qmAecpbVxCBluVE32rKfjf8gYXH4xI2gCv9mRWFhJMHzkPDM4TXlxwPQYIFegymlsy8lXz7optA==", "license": "MIT", "dependencies": { "fast-deep-equal": "^3.1.3", @@ -676,15 +593,18 @@ } }, "node_modules/ansi-styles": { - "version": "3.2.1", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", - "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", - "dev": true, + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "license": "MIT", "dependencies": { - "color-convert": "^1.9.0" + "color-convert": "^2.0.1" }, "engines": { - "node": ">=4" + "node": ">=8" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" } }, "node_modules/argparse": { @@ -696,8 +616,9 @@ "node_modules/array-find-index": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz", - "integrity": "sha1-3wEKoSh+Fku9pvlyOwqWoexBh6E=", + "integrity": "sha512-M1HQyIXcBGtVywBt8WVdim+lrNaK7VHp99Qt5pSNziXznKHViIBbXWtfRTpEFpF/c4FdfxNAsCCwPp5phBYJtw==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -705,111 +626,48 @@ "node_modules/asap": { "version": "2.0.6", "resolved": "https://registry.npmjs.org/asap/-/asap-2.0.6.tgz", - "integrity": "sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=", - "dev": true + "integrity": "sha512-BSHWgDSAiKs50o2Re8ppvp3seVHXSRM44cdSsT9FfNEUUZLOGWVCsiWaRPWM1Znn+mqZ1OfVZ3z3DWEzSp7hRA==", + "dev": true, + "license": "MIT" }, "node_modules/balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==" + "version": "4.0.4", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", + "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==", + "license": "MIT", + "engines": { + "node": "18 || 20 || >=22" + } }, "node_modules/better-ajv-errors": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/better-ajv-errors/-/better-ajv-errors-1.2.0.tgz", - "integrity": "sha512-UW+IsFycygIo7bclP9h5ugkNH8EjCSgqyFB/yQ4Hqqa1OEYDtb0uFIkYE0b6+CjkgJYVM5UKI/pJPxjYe9EZlA==", + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/better-ajv-errors/-/better-ajv-errors-2.0.3.tgz", + "integrity": "sha512-t1vxUP+vYKsaYi/BbKo2K98nEAZmfi4sjwvmRT8aOPDzPJeAtLurfoIDazVkLILxO4K+Sw4YrLYnBQ46l6pePg==", "license": "Apache-2.0", "dependencies": { - "@babel/code-frame": "^7.16.0", - "@humanwhocodes/momoa": "^2.0.2", + "@babel/code-frame": "^7.27.1", + "@humanwhocodes/momoa": "^2.0.4", "chalk": "^4.1.2", - "jsonpointer": "^5.0.0", + "jsonpointer": "^5.0.1", "leven": "^3.1.0 < 4" }, "engines": { - "node": ">= 12.13.0" + "node": ">= 18.20.6" }, "peerDependencies": { "ajv": "4.11.8 - 8" } }, - "node_modules/better-ajv-errors/node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "license": "MIT", - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/better-ajv-errors/node_modules/chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "license": "MIT", - "dependencies": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - }, - "engines": { - "node": ">=10" - }, - "funding": { - "url": "https://github.com/chalk/chalk?sponsor=1" - } - }, - "node_modules/better-ajv-errors/node_modules/color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "license": "MIT", - "dependencies": { - "color-name": "~1.1.4" - }, - "engines": { - "node": ">=7.0.0" - } - }, - "node_modules/better-ajv-errors/node_modules/color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "license": "MIT" - }, - "node_modules/better-ajv-errors/node_modules/has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", - "license": "MIT", - "engines": { - "node": ">=8" - } - }, - "node_modules/better-ajv-errors/node_modules/supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "node_modules/brace-expansion": { + "version": "5.0.6", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.6.tgz", + "integrity": "sha512-kLpxurY4Z4r9sgMsyG0Z9uzsBlgiU/EFKhj/h91/8yHu0edo7XuixOIH3VcJ8kkxs6/jPzoI6U9Vj3WqbMQ94g==", "license": "MIT", "dependencies": { - "has-flag": "^4.0.0" + "balanced-match": "^4.0.2" }, "engines": { - "node": ">=8" - } - }, - "node_modules/brace-expansion": { - "version": "1.1.14", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", - "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", - "dev": true, - "dependencies": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" + "node": "18 || 20 || >=22" } }, "node_modules/call-me-maybe": { @@ -828,17 +686,19 @@ } }, "node_modules/chalk": { - "version": "2.4.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", - "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", - "dev": true, + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "license": "MIT", "dependencies": { - "ansi-styles": "^3.2.1", - "escape-string-regexp": "^1.0.5", - "supports-color": "^5.3.0" + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" }, "engines": { - "node": ">=4" + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" } }, "node_modules/classnames": { @@ -868,19 +728,22 @@ } }, "node_modules/color-convert": { - "version": "1.9.3", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", - "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", - "dev": true, + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "license": "MIT", "dependencies": { - "color-name": "1.1.3" + "color-name": "~1.1.4" + }, + "engines": { + "node": ">=7.0.0" } }, "node_modules/color-name": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", - "integrity": "sha1-p9BVi9icQveV3UIyj3QIMcpTvCU=", - "dev": true + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", + "license": "MIT" }, "node_modules/colorette": { "version": "1.4.0", @@ -891,8 +754,9 @@ "node_modules/concat-map": { "version": "0.0.1", "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", - "dev": true + "integrity": "sha512-/Srv4dswyQNBfohGpz9o6Yb3Gz3SrUDqBH5rTuhGR7ahtlbYKnVxw2bCFMRljaA7EXHaXZ8wsHdodFvbkhKmqg==", + "dev": true, + "license": "MIT" }, "node_modules/cookie": { "version": "0.7.2", @@ -945,6 +809,7 @@ "version": "4.4.3", "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", + "license": "MIT", "dependencies": { "ms": "^2.1.3" }, @@ -960,8 +825,10 @@ "node_modules/debuglog": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/debuglog/-/debuglog-1.0.1.tgz", - "integrity": "sha1-qiT/uaw9+aI1GDfPstJ5NgzXhJI=", + "integrity": "sha512-syBZ+rnAK3EgMsH2aYEOLUW7mZSY9Gb+0wUMCFsZvcmiz+HigA0LOcq/HoQqVuGG+EKykunc7QG2bzrponfaSw==", + "deprecated": "Package no longer supported. Contact Support at https://www.npmjs.com/support for more info.", "dev": true, + "license": "MIT", "engines": { "node": "*" } @@ -976,15 +843,16 @@ "resolved": "https://registry.npmjs.org/dezalgo/-/dezalgo-1.0.4.tgz", "integrity": "sha512-rXSP0bf+5n0Qonsb+SVVfNfIsimO4HEtmnIpPHY8Q1UCzKlQrDMfdobr8nJOOsRgWCyMRqeSBQzmWUMq7zvVig==", "dev": true, + "license": "ISC", "dependencies": { "asap": "^2.0.0", "wrappy": "1" } }, "node_modules/dompurify": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.3.tgz", - "integrity": "sha512-Oj6pzI2+RqBfFG+qOaOLbFXLQ90ARpcGG6UePL82bJLtdsa6CYJD7nmiU8MW9nQNOtCHV3lZ/Bzq1X0QYbBZCA==", + "version": "3.4.5", + "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.4.5.tgz", + "integrity": "sha512-OrwIBKsdNSVEeubdJ1HBv/wNENRM9ytAVCv7YXt//A3vPdVMNuACRqK9mXCGCBW2ln7BT/A4X0jXHo2Gu89miA==", "license": "(MPL-2.0 OR Apache-2.0)", "optionalDependencies": { "@types/trusted-types": "^2.0.7" @@ -1008,6 +876,16 @@ "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", "license": "MIT" }, + "node_modules/es-errors": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz", + "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 0.4" + } + }, "node_modules/es6-promise": { "version": "3.3.1", "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.3.1.tgz", @@ -1026,20 +904,13 @@ "node_modules/escape-string-regexp": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", - "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=", + "integrity": "sha512-vbRorB5FUQWvla16U8R/qgaFIya2qGzwDrNmCZuYKrbdSUMG6I1ZCGQRefkRVhuOkIGVne7BQ35DSfo1qvJqFg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.8.0" } }, - "node_modules/event-target-shim": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz", - "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==", - "engines": { - "node": ">=6" - } - }, "node_modules/eventemitter3": { "version": "5.0.4", "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", @@ -1059,9 +930,9 @@ "license": "MIT" }, "node_modules/fast-uri": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz", - "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==", + "version": "3.1.2", + "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.2.tgz", + "integrity": "sha512-rVjf7ArG3LTk+FS6Yw81V1DLuZl1bRbNrev6Tmd/9RaroeeRRJhAt7jg/6YFxbvAQXUCavSoZhPPj6oOx+5KjQ==", "funding": [ { "type": "github", @@ -1075,34 +946,38 @@ "license": "BSD-3-Clause" }, "node_modules/fast-xml-builder": { - "version": "1.1.5", - "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.5.tgz", - "integrity": "sha512-4TJn/8FKLeslLAH3dnohXqE3QSoxkhvaMzepOIZytwJXZO69Bfz0HBdDHzOTOon6G59Zrk6VQ2bEiv1t61rfkA==", + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.2.0.tgz", + "integrity": "sha512-00aAWieqff+ZJhsXA4g1g7M8k+7AYoMUUHF+/zFb5U6Uv/P0Vl4QZo84/IcufzYalLuEj9928bXN9PbbFzMF0Q==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], + "license": "MIT", "dependencies": { - "path-expression-matcher": "^1.1.3" + "path-expression-matcher": "^1.5.0", + "xml-naming": "^0.1.0" } }, "node_modules/fast-xml-parser": { - "version": "5.7.2", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.7.2.tgz", - "integrity": "sha512-P7oW7tLbYnhOLQk/Gv7cZgzgMPP/XN03K02/Jy6Y/NHzyIAIpxuZIM/YqAkfiXFPxA2CTm7NtCijK9EDu09u2w==", + "version": "5.8.0", + "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.8.0.tgz", + "integrity": "sha512-6bIM7fsJxeo3uXv7OncQYsBAMPJ7V16Slahl/6M98C/i2q+vB1+4a0MtrvYwDFEUrwDSbAmeLDRXsOBwrL7yAg==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } ], + "license": "MIT", "dependencies": { "@nodable/entities": "^2.1.0", - "fast-xml-builder": "^1.1.5", + "fast-xml-builder": "^1.2.0", "path-expression-matcher": "^1.5.0", - "strnum": "^2.2.3" + "strnum": "^2.3.0", + "xml-naming": "^0.1.0" }, "bin": { "fxparser": "src/cli/cli.js" @@ -1117,14 +992,16 @@ "node_modules/fs.realpath": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=", - "dev": true + "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", + "dev": true, + "license": "ISC" }, "node_modules/function-bind": { "version": "1.1.2", "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", "dev": true, + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -1139,20 +1016,17 @@ } }, "node_modules/glob": { - "version": "7.2.3", - "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", - "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", - "dev": true, + "version": "13.0.6", + "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz", + "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", + "license": "BlueOak-1.0.0", "dependencies": { - "fs.realpath": "^1.0.0", - "inflight": "^1.0.4", - "inherits": "2", - "minimatch": "^3.1.1", - "once": "^1.3.0", - "path-is-absolute": "^1.0.0" + "minimatch": "^10.2.2", + "minipass": "^7.1.3", + "path-scurry": "^2.0.2" }, "engines": { - "node": "*" + "node": "18 || 20 || >=22" }, "funding": { "url": "https://github.com/sponsors/isaacs" @@ -1162,7 +1036,8 @@ "version": "4.2.11", "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/handlebars": { "version": "4.7.9", @@ -1186,19 +1061,20 @@ } }, "node_modules/has-flag": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", - "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", - "dev": true, + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==", + "license": "MIT", "engines": { - "node": ">=4" + "node": ">=8" } }, "node_modules/hasown": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", - "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "version": "2.0.3", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.3.tgz", + "integrity": "sha512-ej4AhfhfL2Q2zpMmLo7U1Uv9+PyhIZpgQLGT1F9miIGmiCJIoCgSmczFdrc97mWT4kVY72KA+WnnhJ5pghSvSg==", "dev": true, + "license": "MIT", "dependencies": { "function-bind": "^1.1.2" }, @@ -1210,7 +1086,8 @@ "version": "2.8.9", "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/http2-client": { "version": "1.3.5", @@ -1234,8 +1111,10 @@ "node_modules/inflight": { "version": "1.0.6", "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", - "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=", + "integrity": "sha512-k92I/b08q4wvFscXCLvqfsHCrjrF7yiXsQuIVvVE7N82W3+aqpzuUdBbfhWcy/FZR3/4IgflMgKLOsvPDrGCJA==", + "deprecated": "This module is not supported, and leaks memory. Do not use it. Check out lru-cache if you want a good and tested way to coalesce async requests by a key value, which is much more comprehensive and powerful.", "dev": true, + "license": "ISC", "dependencies": { "once": "^1.3.0", "wrappy": "1" @@ -1244,15 +1123,17 @@ "node_modules/inherits": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", - "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" + "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", + "license": "ISC" }, "node_modules/is-core-module": { - "version": "2.16.1", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", - "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", + "version": "2.16.2", + "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.2.tgz", + "integrity": "sha512-evOr8xfXKxE6qSR0hSXL2r3sd7ALj8+7jQEUvPYcm5sgZFdJ+AYzT6yNmJenvIYQBgIGwfwz08sL8zoL7yq2BA==", "dev": true, + "license": "MIT", "dependencies": { - "hasown": "^2.0.2" + "hasown": "^2.0.3" }, "engines": { "node": ">= 0.4" @@ -1301,7 +1182,8 @@ "version": "2.3.1", "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/json-pointer": { "version": "0.6.2", @@ -1364,6 +1246,7 @@ "resolved": "https://registry.npmjs.org/license-checker/-/license-checker-25.0.1.tgz", "integrity": "sha512-mET5AIwl7MR2IAKYYoVBBpV0OnkKQ1xGj2IMMeEFIs42QAkEVjRtFZGWmQ28WeU7MP779iAgOaOy93Mn44mn6g==", "dev": true, + "license": "BSD-3-Clause", "dependencies": { "chalk": "^2.4.1", "debug": "^3.1.0", @@ -1380,15 +1263,94 @@ "license-checker": "bin/license-checker" } }, + "node_modules/license-checker/node_modules/ansi-styles": { + "version": "3.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", + "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-convert": "^1.9.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/license-checker/node_modules/chalk": { + "version": "2.4.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", + "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^3.2.1", + "escape-string-regexp": "^1.0.5", + "supports-color": "^5.3.0" + }, + "engines": { + "node": ">=4" + } + }, + "node_modules/license-checker/node_modules/color-convert": { + "version": "1.9.3", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", + "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", + "dev": true, + "license": "MIT", + "dependencies": { + "color-name": "1.1.3" + } + }, + "node_modules/license-checker/node_modules/color-name": { + "version": "1.1.3", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", + "integrity": "sha512-72fSenhMw2HZMTVHeCA9KCmpEIbzWiQsjN+BHcBbS9vr1mtt+vJjPdksIBNUmKAW8TFUDPJK5SUU3QhE9NEXDw==", + "dev": true, + "license": "MIT" + }, "node_modules/license-checker/node_modules/debug": { "version": "3.2.7", "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", "dev": true, + "license": "MIT", "dependencies": { "ms": "^2.1.1" } }, + "node_modules/license-checker/node_modules/has-flag": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", + "integrity": "sha512-sKJf1+ceQBr4SMkvQnBDNDtf4TXpVhVGateu0t918bl30FnbE2m4vNLX+VWe/dpjlb+HugGYzW7uQXH98HPEYw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=4" + } + }, + "node_modules/license-checker/node_modules/semver": { + "version": "5.7.2", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", + "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver" + } + }, + "node_modules/license-checker/node_modules/supports-color": { + "version": "5.5.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", + "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", + "dev": true, + "license": "MIT", + "dependencies": { + "has-flag": "^3.0.0" + }, + "engines": { + "node": ">=4" + } + }, "node_modules/long": { "version": "5.3.2", "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz", @@ -1408,9 +1370,9 @@ } }, "node_modules/lru-cache": { - "version": "11.2.7", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz", - "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==", + "version": "11.4.0", + "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.4.0.tgz", + "integrity": "sha512-W+R+kFL4HgVxONq2bhXPi3bGpzGe/yEhVOp233qw9wCRtgncJ15P3bC+e4zZMu4Cq7d+WAJjXGW0uUkifhcatA==", "license": "BlueOak-1.0.0", "engines": { "node": "20 || >=22" @@ -1441,21 +1403,25 @@ } }, "node_modules/minimatch": { - "version": "3.1.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", - "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", - "dev": true, + "version": "10.2.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", + "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", + "license": "BlueOak-1.0.0", "dependencies": { - "brace-expansion": "^1.1.7" + "brace-expansion": "^5.0.5" }, "engines": { - "node": "*" + "node": "18 || 20 || >=22" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" } }, "node_modules/minimist": { "version": "1.2.8", "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==", + "license": "MIT", "funding": { "url": "https://github.com/sponsors/ljharb" } @@ -1474,6 +1440,7 @@ "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", "dev": true, + "license": "MIT", "dependencies": { "minimist": "^1.2.6" }, @@ -1482,9 +1449,9 @@ } }, "node_modules/mobx": { - "version": "6.15.0", - "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.0.tgz", - "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==", + "version": "6.15.3", + "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.3.tgz", + "integrity": "sha512-6+ZSYDs5zgH5CdGfEU2q2Lsa5PztVryL1ys7kAImTU25n2A9LAMj/yneVsQpd03MfwMLDQF+7kakJR9Z+cQxSw==", "license": "MIT", "funding": { "type": "opencollective", @@ -1544,30 +1511,14 @@ "node_modules/ms": { "version": "2.1.3", "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", - "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==" - }, - "node_modules/nanoid": { - "version": "3.3.11", - "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", - "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==", - "funding": [ - { - "type": "github", - "url": "https://github.com/sponsors/ai" - } - ], - "license": "MIT", - "bin": { - "nanoid": "bin/nanoid.cjs" - }, - "engines": { - "node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1" - } + "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==", + "license": "MIT" }, "node_modules/neo-async": { "version": "2.6.2", "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", - "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==" + "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==", + "license": "MIT" }, "node_modules/node-fetch": { "version": "2.7.0", @@ -1615,6 +1566,7 @@ "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.3.tgz", "integrity": "sha512-CvaGwVMztSMJLOeXPrez7fyfObdZqNUK1cPAEzLHrTybIua9pMdmmPR5YwtfNftIOMv3DPUhFaxsZMNTQO20Kg==", "dev": true, + "license": "ISC", "dependencies": { "abbrev": "1", "osenv": "^0.1.4" @@ -1628,6 +1580,7 @@ "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz", "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==", "dev": true, + "license": "BSD-2-Clause", "dependencies": { "hosted-git-info": "^2.1.4", "resolve": "^1.10.0", @@ -1635,11 +1588,22 @@ "validate-npm-package-license": "^3.0.1" } }, + "node_modules/normalize-package-data/node_modules/semver": { + "version": "5.7.2", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", + "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver" + } + }, "node_modules/npm-normalize-package-bin": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-1.0.1.tgz", "integrity": "sha512-EPfafl6JL5/rU+ot6P3gRSCpPDW5VmIzX959Ob1+ySFUuuYHWHekXpwdUZcKP5C+DS4GEtdJluwBjnsNDl+fSA==", - "dev": true + "dev": true, + "license": "ISC" }, "node_modules/oas-kit-common": { "version": "1.0.8", @@ -1723,16 +1687,17 @@ "node_modules/once": { "version": "1.4.0", "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", - "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=", + "integrity": "sha512-lNaJgI+2Q5URQBkccEKHTQOPaXdUxnZZElQTZY0MFUAuaEqe1E+Nyvgdz/aIyNi6Z9MzO5dv1H8n58/GELp3+w==", "dev": true, + "license": "ISC", "dependencies": { "wrappy": "1" } }, "node_modules/openapi-sampler": { - "version": "1.7.2", - "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.2.tgz", - "integrity": "sha512-OKytvqB5XIaTgA9xtw8W8UTar+uymW2xPVpFN0NihMtuHPdPTGxBEhGnfFnJW5g/gOSIvkP+H0Xh3XhVI9/n7g==", + "version": "1.7.3", + "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.3.tgz", + "integrity": "sha512-Qgy2+Z7xR3l7kXurtzi1PCtzAINkFKhBADBe/8cidC2fQrLUQTudLiJjQDnqJXoisWAR6zaHhC0hP6Hn5vja+g==", "license": "MIT", "dependencies": { "@types/json-schema": "^7.0.7", @@ -1743,8 +1708,9 @@ "node_modules/os-homedir": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/os-homedir/-/os-homedir-1.0.2.tgz", - "integrity": "sha1-/7xJiDNuDoM94MFox+8VISGqf7M=", + "integrity": "sha512-B5JU3cabzk8c67mRRd3ECmROafjYMXbuzlwtqdM8IbS8ktlTix8aFGb2bAGKrSRIlnfKwovGUUr72JUPyOb6kQ==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1752,8 +1718,9 @@ "node_modules/os-tmpdir": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz", - "integrity": "sha1-u+Z0BseaqFxc/sdm/lc0VV36EnQ=", + "integrity": "sha512-D2FR03Vir7FIu45XBY20mTb+/ZSWB00sjU9jdQXt83gDrI4Ztz5Fs7/yy74g2N5SVQY4xY1qDr4rNddwYRVX0g==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1762,7 +1729,9 @@ "version": "0.1.5", "resolved": "https://registry.npmjs.org/osenv/-/osenv-0.1.5.tgz", "integrity": "sha512-0CWcCECdMVc2Rw3U5w9ZjqX6ga6ubk1xDVKxtBQPK7wis/0F2r9T6k4ydGYhecl7YUBxBVxhL5oisPsNxAPe2g==", + "deprecated": "This package is no longer supported.", "dev": true, + "license": "ISC", "dependencies": { "os-homedir": "^1.0.0", "os-tmpdir": "^1.0.0" @@ -1790,6 +1759,7 @@ "url": "https://github.com/sponsors/NaturalIntelligence" } ], + "license": "MIT", "engines": { "node": ">=14.0.0" } @@ -1797,8 +1767,9 @@ "node_modules/path-is-absolute": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", - "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=", + "integrity": "sha512-AVbw3UJ2e9bq64vSaS9Am0fje1Pa8pbGqTTsmXfaIiMpnr5DlDhfJOuLj9Sf95ZPVDAUerDfEk88MPmPe7UCQg==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.10.0" } @@ -1807,7 +1778,8 @@ "version": "1.0.7", "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", - "dev": true + "dev": true, + "license": "MIT" }, "node_modules/path-scurry": { "version": "2.0.2", @@ -1870,34 +1842,6 @@ "node": ">=10" } }, - "node_modules/postcss": { - "version": "8.4.49", - "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz", - "integrity": "sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==", - "funding": [ - { - "type": "opencollective", - "url": "https://opencollective.com/postcss/" - }, - { - "type": "tidelift", - "url": "https://tidelift.com/funding/github/npm/postcss" - }, - { - "type": "github", - "url": "https://github.com/sponsors/ai" - } - ], - "license": "MIT", - "dependencies": { - "nanoid": "^3.3.7", - "picocolors": "^1.1.1", - "source-map-js": "^1.2.1" - }, - "engines": { - "node": "^10 || ^12 || >=14" - } - }, "node_modules/postcss-value-parser": { "version": "4.2.0", "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz", @@ -1925,18 +1869,19 @@ } }, "node_modules/protobufjs": { - "version": "7.5.8", - "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.8.tgz", - "integrity": "sha512-dvpCIeLPbXZS/Ete7yLaO7RenOdken2NHKykBXbsaGxZT0UTltcarBciw+A78SRQs9iMAAVpsYA+l8b1hTePIA==", + "version": "7.5.9", + "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.9.tgz", + "integrity": "sha512-Od4muIm3HW1AouyHF5lONOf1FWo3hY1NbFDoy191X9GzhpgW1clCoaFjfVs2rKJNFYpTNJbje4cbAIDBZJ63ZA==", "hasInstallScript": true, + "license": "BSD-3-Clause", "dependencies": { "@protobufjs/aspromise": "^1.1.2", "@protobufjs/base64": "^1.1.2", "@protobufjs/codegen": "^2.0.5", "@protobufjs/eventemitter": "^1.1.0", - "@protobufjs/fetch": "^1.1.0", + "@protobufjs/fetch": "^1.1.1", "@protobufjs/float": "^1.0.2", - "@protobufjs/inquire": "^1.1.1", + "@protobufjs/inquire": "^1.1.2", "@protobufjs/path": "^1.1.2", "@protobufjs/pool": "^1.1.0", "@protobufjs/utf8": "^1.1.1", @@ -1964,35 +1909,37 @@ "type": "consulting", "url": "https://feross.org/support" } - ] + ], + "license": "MIT" }, "node_modules/randombytes": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz", "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==", + "license": "MIT", "dependencies": { "safe-buffer": "^5.1.0" } }, "node_modules/react": { - "version": "19.2.4", - "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", - "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==", + "version": "19.2.6", + "resolved": "https://registry.npmjs.org/react/-/react-19.2.6.tgz", + "integrity": "sha512-sfWGGfavi0xr8Pg0sVsyHMAOziVYKgPLNrS7ig+ivMNb3wbCBw3KxtflsGBAwD3gYQlE/AEZsTLgToRrSCjb0Q==", "license": "MIT", "engines": { "node": ">=0.10.0" } }, "node_modules/react-dom": { - "version": "19.2.4", - "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", - "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", + "version": "19.2.6", + "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.6.tgz", + "integrity": "sha512-0prMI+hvBbPjsWnxDLxlCGyM8PN6UuWjEUCYmZhO67xIV9Xasa/r/vDnq+Xyq4Lo27g8QSbO5YzARu0D1Sps3g==", "license": "MIT", "dependencies": { "scheduler": "^0.27.0" }, "peerDependencies": { - "react": "^19.2.4" + "react": "^19.2.6" } }, "node_modules/react-is": { @@ -2017,8 +1964,10 @@ "node_modules/read-installed": { "version": "4.0.3", "resolved": "https://registry.npmjs.org/read-installed/-/read-installed-4.0.3.tgz", - "integrity": "sha1-/5uLZ/GH0eTCm5/rMfayI6zRkGc=", + "integrity": "sha512-O03wg/IYuV/VtnK2h/KXEt9VIbMUFbk3ERG0Iu4FhLZw0EP0T9znqrYDGn6ncbEsXUFaUjiVAWXHzxwt3lhRPQ==", + "deprecated": "This package is no longer supported.", "dev": true, + "license": "ISC", "dependencies": { "debuglog": "^1.0.1", "read-package-json": "^2.0.0", @@ -2031,11 +1980,23 @@ "graceful-fs": "^4.1.2" } }, + "node_modules/read-installed/node_modules/semver": { + "version": "5.7.2", + "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", + "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", + "dev": true, + "license": "ISC", + "bin": { + "semver": "bin/semver" + } + }, "node_modules/read-package-json": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/read-package-json/-/read-package-json-2.1.2.tgz", "integrity": "sha512-D1KmuLQr6ZSJS0tW8hf3WGpRlwszJOXZ3E8Yd/DNRaM5d+1wVRZdHlpGBLAuovjr28LbWvjpWkBHMxpRGGjzNA==", + "deprecated": "This package is no longer supported. Please use @npmcli/package-json instead.", "dev": true, + "license": "ISC", "dependencies": { "glob": "^7.1.1", "json-parse-even-better-errors": "^2.3.0", @@ -2043,6 +2004,59 @@ "npm-normalize-package-bin": "^1.0.0" } }, + "node_modules/read-package-json/node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "dev": true, + "license": "MIT" + }, + "node_modules/read-package-json/node_modules/brace-expansion": { + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", + "dev": true, + "license": "MIT", + "dependencies": { + "balanced-match": "^1.0.0", + "concat-map": "0.0.1" + } + }, + "node_modules/read-package-json/node_modules/glob": { + "version": "7.2.3", + "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", + "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", + "deprecated": "Old versions of glob are not supported, and contain widely publicized security vulnerabilities, which have been fixed in the current version. Please update. Support for old versions may be purchased (at exorbitant rates) by contacting i@izs.me", + "dev": true, + "license": "ISC", + "dependencies": { + "fs.realpath": "^1.0.0", + "inflight": "^1.0.4", + "inherits": "2", + "minimatch": "^3.1.1", + "once": "^1.3.0", + "path-is-absolute": "^1.0.0" + }, + "engines": { + "node": "*" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/read-package-json/node_modules/minimatch": { + "version": "3.1.5", + "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", + "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", + "dev": true, + "license": "ISC", + "dependencies": { + "brace-expansion": "^1.1.7" + }, + "engines": { + "node": "*" + } + }, "node_modules/readable-stream": { "version": "3.6.2", "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", @@ -2063,6 +2077,7 @@ "integrity": "sha512-asaikDeqAQg7JifRsZn1NJZXo9E+VwlyCfbkZhwyISinqk5zNS6266HS5kah6P0SaQKGF6SkNnZVHUzHFYxYDw==", "deprecated": "This functionality has been moved to @npmcli/fs", "dev": true, + "license": "ISC", "dependencies": { "debuglog": "^1.0.1", "dezalgo": "^1.0.0", @@ -2133,9 +2148,9 @@ "license": "MIT" }, "node_modules/redoc/node_modules/@redocly/openapi-core": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", - "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", + "version": "1.34.14", + "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.14.tgz", + "integrity": "sha512-y+xFx+Zz54Xhr8jUdnLENYnt7Y7GEDL6Q03ga7rTtX8DVwefX9H+hQEPgJp1nda7vdH+wJ9/HBVvyfBuW9x6rA==", "license": "MIT", "dependencies": { "@redocly/ajv": "8.11.2", @@ -2153,10 +2168,17 @@ "npm": ">=9.5.0" } }, + "node_modules/redoc/node_modules/balanced-match": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", + "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==", + "license": "MIT" + }, "node_modules/redoc/node_modules/brace-expansion": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.0.tgz", "integrity": "sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==", + "license": "MIT", "dependencies": { "balanced-match": "^1.0.0" } @@ -2201,11 +2223,13 @@ } }, "node_modules/resolve": { - "version": "1.22.11", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz", - "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==", + "version": "1.22.12", + "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.12.tgz", + "integrity": "sha512-TyeJ1zif53BPfHootBGwPRYT1RUt6oGWsaQr8UyZW/eAm9bKoijtvruSDEmZHm92CwS9nj7/fWttqPCgzep8CA==", "dev": true, + "license": "MIT", "dependencies": { + "es-errors": "^1.3.0", "is-core-module": "^2.16.1", "path-parse": "^1.0.7", "supports-preserve-symlinks-flag": "^1.0.0" @@ -2237,7 +2261,8 @@ "type": "consulting", "url": "https://feross.org/support" } - ] + ], + "license": "MIT" }, "node_modules/scheduler": { "version": "0.27.0", @@ -2246,12 +2271,15 @@ "license": "MIT" }, "node_modules/semver": { - "version": "5.7.2", - "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", - "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", - "dev": true, + "version": "7.8.0", + "resolved": "https://registry.npmjs.org/semver/-/semver-7.8.0.tgz", + "integrity": "sha512-AcM7dV/5ul4EekoQ29Agm5vri8JNqRyj39o0qpX6vDF2GZrtutZl5RwgD1XnZjiTAfncsJhMI48QQH3sN87YNA==", + "license": "ISC", "bin": { - "semver": "bin/semver" + "semver": "bin/semver.js" + }, + "engines": { + "node": ">=10" } }, "node_modules/set-cookie-parser": { @@ -2260,12 +2288,6 @@ "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==", "license": "MIT" }, - "node_modules/shallowequal": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/shallowequal/-/shallowequal-1.1.0.tgz", - "integrity": "sha512-y0m1JoUZSlPAjXVtPPW70aZWfIL/dSP7AFkRnniLCrK/8MDKog3TySTBmckD+RObVxH0v4Tox67+F14PdED2oQ==", - "license": "MIT" - }, "node_modules/should": { "version": "13.2.3", "resolved": "https://registry.npmjs.org/should/-/should-13.2.3.tgz", @@ -2338,6 +2360,7 @@ "url": "https://feross.org/support" } ], + "license": "MIT", "dependencies": { "debug": "^4.3.1", "queue-microtask": "^1.2.2", @@ -2349,8 +2372,9 @@ "node_modules/slide": { "version": "1.1.6", "resolved": "https://registry.npmjs.org/slide/-/slide-1.1.6.tgz", - "integrity": "sha1-VusCfWW00tzmyy4tMsTUr8nh1wc=", + "integrity": "sha512-NwrtjCg+lZoqhFU8fOwl4ay2ei8PaqCBOUV3/ektPY9trO1yQ1oXEfmHAhKArUVUr/hOHvy5f6AdP17dCM0zMw==", "dev": true, + "license": "ISC", "engines": { "node": "*" } @@ -2368,14 +2392,6 @@ "version": "0.6.1", "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==", - "engines": { - "node": ">=0.10.0" - } - }, - "node_modules/source-map-js": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", - "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==", "license": "BSD-3-Clause", "engines": { "node": ">=0.10.0" @@ -2386,6 +2402,7 @@ "resolved": "https://registry.npmjs.org/spdx-compare/-/spdx-compare-1.0.0.tgz", "integrity": "sha512-C1mDZOX0hnu0ep9dfmuoi03+eOdDoz2yvK79RxbcrVEG1NO1Ph35yW102DHWKN4pk80nwCgeMmSY5L25VE4D9A==", "dev": true, + "license": "MIT", "dependencies": { "array-find-index": "^1.0.2", "spdx-expression-parse": "^3.0.0", @@ -2397,6 +2414,7 @@ "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.2.0.tgz", "integrity": "sha512-kN9dJbvnySHULIluDHy32WHRUu3Og7B9sbY7tsFLctQkIqnMh3hErYgdMjTYuqmcXX+lK5T1lnUt3G7zNswmZA==", "dev": true, + "license": "Apache-2.0", "dependencies": { "spdx-expression-parse": "^3.0.0", "spdx-license-ids": "^3.0.0" @@ -2406,13 +2424,15 @@ "version": "2.5.0", "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.5.0.tgz", "integrity": "sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==", - "dev": true + "dev": true, + "license": "CC-BY-3.0" }, "node_modules/spdx-expression-parse": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.1.tgz", "integrity": "sha512-cbqHunsQWnJNE6KhVSMsMeH5H/L9EpymbzqTQ3uLwNCLZ1Q481oWaofqH7nO6V07xlXwY6PhQdQ2IedWx/ZK4Q==", "dev": true, + "license": "MIT", "dependencies": { "spdx-exceptions": "^2.1.0", "spdx-license-ids": "^3.0.0" @@ -2422,19 +2442,22 @@ "version": "3.0.23", "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.23.tgz", "integrity": "sha512-CWLcCCH7VLu13TgOH+r8p1O/Znwhqv/dbb6lqWy67G+pT1kHmeD/+V36AVb/vq8QMIQwVShJ6Ssl5FPh0fuSdw==", - "dev": true + "dev": true, + "license": "CC0-1.0" }, "node_modules/spdx-ranges": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/spdx-ranges/-/spdx-ranges-2.1.1.tgz", "integrity": "sha512-mcdpQFV7UDAgLpXEE/jOMqvK4LBoO0uTQg0uvXUewmEFhpiZx5yJSZITHB8w1ZahKdhfZqP5GPEOKLyEq5p8XA==", - "dev": true + "dev": true, + "license": "(MIT AND CC-BY-3.0)" }, "node_modules/spdx-satisfies": { "version": "4.0.1", "resolved": "https://registry.npmjs.org/spdx-satisfies/-/spdx-satisfies-4.0.1.tgz", "integrity": "sha512-WVzZ/cXAzoNmjCWiEluEA3BjHp5tiUmmhn9MK+X0tBbR9sOqtC6UQwmgCNrAIZvNlMuBUYAaHYfb2oqlF9SwKA==", "dev": true, + "license": "MIT", "dependencies": { "spdx-compare": "^1.0.0", "spdx-expression-parse": "^3.0.0", @@ -2450,6 +2473,7 @@ "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", + "license": "MIT", "dependencies": { "safe-buffer": "~5.2.0" } @@ -2481,31 +2505,27 @@ } }, "node_modules/strnum": { - "version": "2.2.3", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.3.tgz", - "integrity": "sha512-oKx6RUCuHfT3oyVjtnrmn19H1SiCqgJSg+54XqURKp5aCMbrXrhLjRN9TjuwMjiYstZ0MzDrHqkGZ5dFTKd+zg==", + "version": "2.3.0", + "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.3.0.tgz", + "integrity": "sha512-ums3KNd42PGyx5xaoVTO1mjU1bH3NpY4vsrVlnv9PNGqQj8wd7rJ6nEypLrJ7z5vxK5RP0yMLo6J/Gsm62DI5Q==", "funding": [ { "type": "github", "url": "https://github.com/sponsors/NaturalIntelligence" } - ] + ], + "license": "MIT" }, "node_modules/styled-components": { - "version": "6.3.9", - "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.3.9.tgz", - "integrity": "sha512-J72R4ltw0UBVUlEjTzI0gg2STOqlI9JBhQOL4Dxt7aJOnnSesy0qJDn4PYfMCafk9cWOaVg129Pesl5o+DIh0Q==", + "version": "6.4.1", + "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.4.1.tgz", + "integrity": "sha512-ADu2dF53esUzzM4I0ewxhxFtsDd6v4V6dNkg3vG0iFKhnt06sJneTZnRvujAosZwW0XD58IKgGMQoqri4wHRqg==", "license": "MIT", "dependencies": { "@emotion/is-prop-valid": "1.4.0", - "@emotion/unitless": "0.10.0", - "@types/stylis": "4.2.7", "css-to-react-native": "3.2.0", "csstype": "3.2.3", - "postcss": "8.4.49", - "shallowequal": "1.1.0", - "stylis": "4.3.6", - "tslib": "2.8.1" + "stylis": "4.3.6" }, "engines": { "node": ">= 16" @@ -2515,12 +2535,20 @@ "url": "https://opencollective.com/styled-components" }, "peerDependencies": { + "css-to-react-native": ">= 3.2.0", "react": ">= 16.8.0", - "react-dom": ">= 16.8.0" + "react-dom": ">= 16.8.0", + "react-native": ">= 0.68.0" }, "peerDependenciesMeta": { + "css-to-react-native": { + "optional": true + }, "react-dom": { "optional": true + }, + "react-native": { + "optional": true } } }, @@ -2531,15 +2559,15 @@ "license": "MIT" }, "node_modules/supports-color": { - "version": "5.5.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", - "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", - "dev": true, + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "license": "MIT", "dependencies": { - "has-flag": "^3.0.0" + "has-flag": "^4.0.0" }, "engines": { - "node": ">=4" + "node": ">=8" } }, "node_modules/supports-preserve-symlinks-flag": { @@ -2547,6 +2575,7 @@ "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", "dev": true, + "license": "MIT", "engines": { "node": ">= 0.4" }, @@ -2592,6 +2621,7 @@ "resolved": "https://registry.npmjs.org/treeify/-/treeify-1.1.0.tgz", "integrity": "sha512-1m4RA7xVAJrSGrrXGs0L3YTwyvBs2S8PbRHaLZAkFw7JR8oIFwYtysxlBZhYIa7xSyiYJKZ3iGrrk55cGA3i9A==", "dev": true, + "license": "MIT", "engines": { "node": ">=0.6" } @@ -2602,16 +2632,11 @@ "integrity": "sha512-kloPhf1hq3JbCPOTYoOWDKxebWjNb2o/LKnNfkWhxVVisFFmMJPPdJeGoGmM+iRLyoXAR61e08Pb+vUXINg8aA==", "license": "MIT" }, - "node_modules/tslib": { - "version": "2.8.1", - "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", - "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==", - "license": "0BSD" - }, "node_modules/uglify-js": { "version": "3.19.3", "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", + "license": "BSD-2-Clause", "optional": true, "bin": { "uglifyjs": "bin/uglifyjs" @@ -2639,9 +2664,9 @@ } }, "node_modules/undici-types": { - "version": "7.18.2", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", - "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==", + "version": "7.24.6", + "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.24.6.tgz", + "integrity": "sha512-WRNW+sJgj5OBN4/0JpHFqtqzhpbnV0GuB+OozA9gCL7a993SmU+1JBZCzLNxYsbMfIeDL+lTsphD5jN5N+n0zg==", "license": "MIT" }, "node_modules/uri-js-replace": { @@ -2668,19 +2693,22 @@ "node_modules/util-deprecate": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", - "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==" + "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==", + "license": "MIT" }, "node_modules/util-extend": { "version": "1.0.3", "resolved": "https://registry.npmjs.org/util-extend/-/util-extend-1.0.3.tgz", - "integrity": "sha1-p8IW0mdUUWljeztu3GypEZ4v+T8=", - "dev": true + "integrity": "sha512-mLs5zAK+ctllYBj+iAQvlDCwoxU/WDOUaJkcFudeiAX6OajC6BKXJUa9a+tbtkC11dz2Ufb7h0lyvIOVn4LADA==", + "dev": true, + "license": "MIT" }, "node_modules/validate-npm-package-license": { "version": "3.0.4", "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz", "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==", "dev": true, + "license": "Apache-2.0", "dependencies": { "spdx-correct": "^3.0.0", "spdx-expression-parse": "^3.0.0" @@ -2705,7 +2733,8 @@ "node_modules/wordwrap": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", - "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==" + "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==", + "license": "MIT" }, "node_modules/wrap-ansi": { "version": "7.0.0", @@ -2724,49 +2753,18 @@ "url": "https://github.com/chalk/wrap-ansi?sponsor=1" } }, - "node_modules/wrap-ansi/node_modules/ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "license": "MIT", - "dependencies": { - "color-convert": "^2.0.1" - }, - "engines": { - "node": ">=8" - }, - "funding": { - "url": "https://github.com/chalk/ansi-styles?sponsor=1" - } - }, - "node_modules/wrap-ansi/node_modules/color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "license": "MIT", - "dependencies": { - "color-name": "~1.1.4" - }, - "engines": { - "node": ">=7.0.0" - } - }, - "node_modules/wrap-ansi/node_modules/color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", - "license": "MIT" - }, "node_modules/wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", - "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=", - "dev": true + "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", + "dev": true, + "license": "ISC" }, "node_modules/ws": { "version": "7.5.10", "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz", "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==", + "license": "MIT", "engines": { "node": ">=8.3.0" }, @@ -2783,6 +2781,21 @@ } } }, + "node_modules/xml-naming": { + "version": "0.1.0", + "resolved": "https://registry.npmjs.org/xml-naming/-/xml-naming-0.1.0.tgz", + "integrity": "sha512-k8KO9hrMyNk6tUWqUfkTEZbezRRpONVOzUTnc97VnCvyj6Tf9lyUR9EDAIeiVLv56jsMcoXEwjW8Kv5yPY52lw==", + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/NaturalIntelligence" + } + ], + "license": "MIT", + "engines": { + "node": ">=16.0.0" + } + }, "node_modules/y18n": { "version": "5.0.8", "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", @@ -2834,1954 +2847,5 @@ "node": ">=10" } } - }, - "dependencies": { - "@babel/code-frame": { - "version": "7.29.0", - "resolved": "https://registry.npmjs.org/@babel/code-frame/-/code-frame-7.29.0.tgz", - "integrity": "sha512-9NhCeYjq9+3uxgdtp20LSiJXJvN0FeCtNGpJxuMFZ1Kv3cWUNb6DOhJwUvcVCzKGR66cw4njwM6hrJLqgOwbcw==", - "requires": { - "@babel/helper-validator-identifier": "^7.28.5", - "js-tokens": "^4.0.0", - "picocolors": "^1.1.1" - } - }, - "@babel/helper-validator-identifier": { - "version": "7.28.5", - "resolved": "https://registry.npmjs.org/@babel/helper-validator-identifier/-/helper-validator-identifier-7.28.5.tgz", - "integrity": "sha512-qSs4ifwzKJSV39ucNjsvc6WVHs6b7S03sOh2OcHF9UHfVPqWWALUsNUVzhSBiItjRZoLHx7nIarVjqKVusUZ1Q==" - }, - "@babel/runtime": { - "version": "7.29.2", - "resolved": "https://registry.npmjs.org/@babel/runtime/-/runtime-7.29.2.tgz", - "integrity": "sha512-JiDShH45zKHWyGe4ZNVRrCjBz8Nh9TMmZG1kh4QTK8hCBTWBi8Da+i7s1fJw7/lYpM4ccepSNfqzZ/QvABBi5g==" - }, - "@emotion/is-prop-valid": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/@emotion/is-prop-valid/-/is-prop-valid-1.4.0.tgz", - "integrity": "sha512-QgD4fyscGcbbKwJmqNvUMSE02OsHUa+lAWKdEUIJKgqe5IwRSKd7+KhibEWdaKwgjLj0DRSHA9biAIqGBk05lw==", - "requires": { - "@emotion/memoize": "^0.9.0" - } - }, - "@emotion/memoize": { - "version": "0.9.0", - "resolved": "https://registry.npmjs.org/@emotion/memoize/-/memoize-0.9.0.tgz", - "integrity": "sha512-30FAj7/EoJ5mwVPOWhAyCX+FPfMDrVecJAM+Iw9NRoSl4BBAQeqj4cApHHUXOVvIPgLVDsCFoz/hGD+5QQD1GQ==" - }, - "@emotion/unitless": { - "version": "0.10.0", - "resolved": "https://registry.npmjs.org/@emotion/unitless/-/unitless-0.10.0.tgz", - "integrity": "sha512-dFoMUuQA20zvtVTuxZww6OHoJYgrzfKM1t52mVySDJnMSEa08ruEvdYQbhvyu6soU+NeLVd3yKfTfT0NeV6qGg==" - }, - "@exodus/schemasafe": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/@exodus/schemasafe/-/schemasafe-1.3.0.tgz", - "integrity": "sha512-5Aap/GaRupgNx/feGBwLLTVv8OQFfv3pq2lPRzPg9R+IOBnDgghTGW7l7EuVXOvg5cc/xSAlRW8rBrjIC3Nvqw==" - }, - "@faker-js/faker": { - "version": "7.6.0", - "resolved": "https://registry.npmjs.org/@faker-js/faker/-/faker-7.6.0.tgz", - "integrity": "sha512-XK6BTq1NDMo9Xqw/YkYyGjSsg44fbNwYRx7QK2CuoQgyy+f1rrTDHoExVM5PsyXCtfl2vs2vVJ0MN0yN6LppRw==" - }, - "@humanwhocodes/momoa": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/@humanwhocodes/momoa/-/momoa-2.0.4.tgz", - "integrity": "sha512-RE815I4arJFtt+FVeU1Tgp9/Xvecacji8w/V6XtXsWWH/wz/eNkNbhb+ny/+PlVZjV0rxQpRSQKNKE3lcktHEA==" - }, - "@noble/hashes": { - "version": "1.8.0", - "resolved": "https://registry.npmjs.org/@noble/hashes/-/hashes-1.8.0.tgz", - "integrity": "sha512-jCs9ldd7NwzpgXDIf6P3+NrHh9/sD6CQdxHyjQI+h/6rDNo88ypBxxz45UDuZHz9r3tNz7N/VInSVoVdtXEI4A==" - }, - "@nodable/entities": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/@nodable/entities/-/entities-2.1.0.tgz", - "integrity": "sha512-nyT7T3nbMyBI/lvr6L5TyWbFJAI9FTgVRakNoBqCD+PmID8DzFrrNdLLtHMwMszOtqZa8PAOV24ZqDnQrhQINA==" - }, - "@opentelemetry/api": { - "version": "1.9.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/api/-/api-1.9.1.tgz", - "integrity": "sha512-gLyJlPHPZYdAk1JENA9LeHejZe1Ti77/pTeFm/nMXmQH/HFZlcS/O2XJB+L8fkbrNSqhdtlvjBVjxwUYanNH5Q==" - }, - "@opentelemetry/api-logs": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/api-logs/-/api-logs-0.202.0.tgz", - "integrity": "sha512-fTBjMqKCfotFWfLzaKyhjLvyEyq5vDKTTFfBmx21btv3gvy8Lq6N5Dh2OzqeuN4DjtpSvNT1uNVfg08eD2Rfxw==", - "requires": { - "@opentelemetry/api": "^1.3.0" - } - }, - "@opentelemetry/context-async-hooks": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/context-async-hooks/-/context-async-hooks-2.0.1.tgz", - "integrity": "sha512-XuY23lSI3d4PEqKA+7SLtAgwqIfc6E/E9eAQWLN1vlpC53ybO3o6jW4BsXo1xvz9lYyyWItfQDDLzezER01mCw==", - "requires": {} - }, - "@opentelemetry/core": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/core/-/core-2.0.1.tgz", - "integrity": "sha512-MaZk9SJIDgo1peKevlbhP6+IwIiNPNmswNL4AF0WaQJLbHXjr9SrZMgS12+iqr9ToV4ZVosCcc0f8Rg67LXjxw==", - "requires": { - "@opentelemetry/semantic-conventions": "^1.29.0" - } - }, - "@opentelemetry/exporter-trace-otlp-http": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/exporter-trace-otlp-http/-/exporter-trace-otlp-http-0.202.0.tgz", - "integrity": "sha512-/hKE8DaFCJuaQqE1IxpgkcjOolUIwgi3TgHElPVKGdGRBSmJMTmN/cr6vWa55pCJIXPyhKvcMrbrya7DZ3VmzA==", - "requires": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/otlp-exporter-base": "0.202.0", - "@opentelemetry/otlp-transformer": "0.202.0", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/sdk-trace-base": "2.0.1" - } - }, - "@opentelemetry/otlp-exporter-base": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-exporter-base/-/otlp-exporter-base-0.202.0.tgz", - "integrity": "sha512-nMEOzel+pUFYuBJg2znGmHJWbmvMbdX5/RhoKNKowguMbURhz0fwik5tUKplLcUtl8wKPL1y9zPnPxeBn65N0Q==", - "requires": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/otlp-transformer": "0.202.0" - } - }, - "@opentelemetry/otlp-transformer": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/otlp-transformer/-/otlp-transformer-0.202.0.tgz", - "integrity": "sha512-5XO77QFzs9WkexvJQL9ksxL8oVFb/dfi9NWQSq7Sv0Efr9x3N+nb1iklP1TeVgxqJ7m1xWiC/Uv3wupiQGevMw==", - "requires": { - "@opentelemetry/api-logs": "0.202.0", - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/sdk-logs": "0.202.0", - "@opentelemetry/sdk-metrics": "2.0.1", - "@opentelemetry/sdk-trace-base": "2.0.1", - "protobufjs": "^7.3.0" - } - }, - "@opentelemetry/resources": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/resources/-/resources-2.0.1.tgz", - "integrity": "sha512-dZOB3R6zvBwDKnHDTB4X1xtMArB/d324VsbiPkX/Yu0Q8T2xceRthoIVFhJdvgVM2QhGVUyX9tzwiNxGtoBJUw==", - "requires": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/semantic-conventions": "^1.29.0" - } - }, - "@opentelemetry/sdk-logs": { - "version": "0.202.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-logs/-/sdk-logs-0.202.0.tgz", - "integrity": "sha512-pv8QiQLQzk4X909YKm0lnW4hpuQg4zHwJ4XBd5bZiXcd9urvrJNoNVKnxGHPiDVX/GiLFvr5DMYsDBQbZCypRQ==", - "requires": { - "@opentelemetry/api-logs": "0.202.0", - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1" - } - }, - "@opentelemetry/sdk-metrics": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-metrics/-/sdk-metrics-2.0.1.tgz", - "integrity": "sha512-wf8OaJoSnujMAHWR3g+/hGvNcsC16rf9s1So4JlMiFaFHiE4HpIA3oUh+uWZQ7CNuK8gVW/pQSkgoa5HkkOl0g==", - "requires": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1" - } - }, - "@opentelemetry/sdk-trace-base": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-base/-/sdk-trace-base-2.0.1.tgz", - "integrity": "sha512-xYLlvk/xdScGx1aEqvxLwf6sXQLXCjk3/1SQT9X9AoN5rXRhkdvIFShuNNmtTEPRBqcsMbS4p/gJLNI2wXaDuQ==", - "requires": { - "@opentelemetry/core": "2.0.1", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/semantic-conventions": "^1.29.0" - } - }, - "@opentelemetry/sdk-trace-node": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/@opentelemetry/sdk-trace-node/-/sdk-trace-node-2.0.1.tgz", - "integrity": "sha512-UhdbPF19pMpBtCWYP5lHbTogLWx9N0EBxtdagvkn5YtsAnCBZzL7SjktG+ZmupRgifsHMjwUaCCaVmqGfSADmA==", - "requires": { - "@opentelemetry/context-async-hooks": "2.0.1", - "@opentelemetry/core": "2.0.1", - "@opentelemetry/sdk-trace-base": "2.0.1" - } - }, - "@opentelemetry/semantic-conventions": { - "version": "1.34.0", - "resolved": "https://registry.npmjs.org/@opentelemetry/semantic-conventions/-/semantic-conventions-1.34.0.tgz", - "integrity": "sha512-aKcOkyrorBGlajjRdVoJWHTxfxO1vCNHLJVlSDaRHDIdjU+pX8IYQPvPDkYiujKLbRnWU+1TBwEt0QRgSm4SGA==" - }, - "@protobufjs/aspromise": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/@protobufjs/aspromise/-/aspromise-1.1.2.tgz", - "integrity": "sha512-j+gKExEuLmKwvz3OgROXtrJ2UG2x8Ch2YZUxahh+s1F2HZ+wAceUNLkvy6zKCPVRkU++ZWQrdxsUeQXmcg4uoQ==" - }, - "@protobufjs/base64": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/@protobufjs/base64/-/base64-1.1.2.tgz", - "integrity": "sha512-AZkcAA5vnN/v4PDqKyMR5lx7hZttPDgClv83E//FMNhR2TMcLUhfRUBHCmSl0oi9zMgDDqRUJkSxO3wm85+XLg==" - }, - "@protobufjs/codegen": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/@protobufjs/codegen/-/codegen-2.0.5.tgz", - "integrity": "sha512-zgXFLzW3Ap33e6d0Wlj4MGIm6Ce8O89n/apUaGNB/jx+hw+ruWEp7EwGUshdLKVRCxZW12fp9r40E1mQrf/34g==" - }, - "@protobufjs/eventemitter": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/eventemitter/-/eventemitter-1.1.0.tgz", - "integrity": "sha512-j9ednRT81vYJ9OfVuXG6ERSTdEL1xVsNgqpkxMsbIabzSo3goCjDIveeGv5d03om39ML71RdmrGNjG5SReBP/Q==" - }, - "@protobufjs/fetch": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/fetch/-/fetch-1.1.0.tgz", - "integrity": "sha512-lljVXpqXebpsijW71PZaCYeIcE5on1w5DlQy5WH6GLbFryLUrBD4932W/E2BSpfRJWseIL4v/KPgBFxDOIdKpQ==", - "requires": { - "@protobufjs/aspromise": "^1.1.1", - "@protobufjs/inquire": "^1.1.0" - } - }, - "@protobufjs/float": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/@protobufjs/float/-/float-1.0.2.tgz", - "integrity": "sha512-Ddb+kVXlXst9d+R9PfTIxh1EdNkgoRe5tOX6t01f1lYWOvJnSPDBlG241QLzcyPdoNTsblLUdujGSE4RzrTZGQ==" - }, - "@protobufjs/inquire": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/@protobufjs/inquire/-/inquire-1.1.1.tgz", - "integrity": "sha512-mnzgDV26ueAvk7rsbt9L7bE0SuAoqyuys/sMMrmVcN5x9VsxpcG3rqAUSgDyLp0UZlmNfIbQ4fHfCtreVBk8Ew==" - }, - "@protobufjs/path": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/@protobufjs/path/-/path-1.1.2.tgz", - "integrity": "sha512-6JOcJ5Tm08dOHAbdR3GrvP+yUUfkjG5ePsHYczMFLq3ZmMkAD98cDgcT2iA1lJ9NVwFd4tH/iSSoe44YWkltEA==" - }, - "@protobufjs/pool": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/@protobufjs/pool/-/pool-1.1.0.tgz", - "integrity": "sha512-0kELaGSIDBKvcgS4zkjz1PeddatrjYcmMWOlAuAPwAeccUrPHdUqo/J6LiymHHEiJT5NrF1UVwxY14f+fy4WQw==" - }, - "@protobufjs/utf8": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/@protobufjs/utf8/-/utf8-1.1.1.tgz", - "integrity": "sha512-oOAWABowe8EAbMyWKM0tYDKi8Yaox52D+HWZhAIJqQXbqe0xI/GV7FhLWqlEKreMkfDjshR5FKgi3mnle0h6Eg==" - }, - "@redocly/ajv": { - "version": "8.18.1", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.1.tgz", - "integrity": "sha512-Ifm/pP/tul1qmAecpbVxCBluVE32rKfjf8gYXH4xI2gCv9mRWFhJMHzkPDM4TXlxwPQYIFegymlsy8lXz7optA==", - "requires": { - "fast-deep-equal": "^3.1.3", - "fast-uri": "^3.0.1", - "json-schema-traverse": "^1.0.0", - "require-from-string": "^2.0.2" - } - }, - "@redocly/cli": { - "version": "2.25.3", - "resolved": "https://registry.npmjs.org/@redocly/cli/-/cli-2.25.3.tgz", - "integrity": "sha512-02wjApwJwGD+kGWRoiFVY0Hq960ydMAMHrK3AJH2LMiYNYcrzAr1FSbA3OSylvg2gx3w/r1r710B+iMz3KJKbw==", - "requires": { - "@opentelemetry/exporter-trace-otlp-http": "0.202.0", - "@opentelemetry/resources": "2.0.1", - "@opentelemetry/sdk-trace-node": "2.0.1", - "@opentelemetry/semantic-conventions": "1.34.0", - "@redocly/cli-otel": "0.1.2", - "@redocly/openapi-core": "2.25.3", - "@redocly/respect-core": "2.25.3", - "abort-controller": "^3.0.0", - "ajv": "npm:@redocly/ajv@8.18.0", - "ajv-formats": "^3.0.1", - "colorette": "^1.2.0", - "cookie": "^0.7.2", - "dotenv": "16.4.7", - "glob": "^13.0.5", - "handlebars": "^4.7.9", - "https-proxy-agent": "^7.0.5", - "mobx": "^6.0.4", - "picomatch": "^4.0.4", - "pluralize": "^8.0.0", - "react": "^17.0.0 || ^18.2.0 || ^19.2.1", - "react-dom": "^17.0.0 || ^18.2.0 || ^19.2.1", - "redoc": "2.5.1", - "semver": "^7.5.2", - "set-cookie-parser": "^2.3.5", - "simple-websocket": "^9.0.0", - "styled-components": "6.3.9", - "ulid": "^3.0.1", - "undici": "6.24.0", - "yargs": "17.0.1" - }, - "dependencies": { - "balanced-match": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-4.0.4.tgz", - "integrity": "sha512-BLrgEcRTwX2o6gGxGOCNyMvGSp35YofuYzw9h1IMTRmKqttAZZVU67bdb9Pr2vUHA8+j3i2tJfjO6C6+4myGTA==" - }, - "brace-expansion": { - "version": "5.0.5", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-5.0.5.tgz", - "integrity": "sha512-VZznLgtwhn+Mact9tfiwx64fA9erHH/MCXEUfB/0bX/6Fz6ny5EGTXYltMocqg4xFAQZtnO3DHWWXi8RiuN7cQ==", - "requires": { - "balanced-match": "^4.0.2" - } - }, - "glob": { - "version": "13.0.6", - "resolved": "https://registry.npmjs.org/glob/-/glob-13.0.6.tgz", - "integrity": "sha512-Wjlyrolmm8uDpm/ogGyXZXb1Z+Ca2B8NbJwqBVg0axK9GbBeoS7yGV6vjXnYdGm6X53iehEuxxbyiKp8QmN4Vw==", - "requires": { - "minimatch": "^10.2.2", - "minipass": "^7.1.3", - "path-scurry": "^2.0.2" - } - }, - "minimatch": { - "version": "10.2.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-10.2.5.tgz", - "integrity": "sha512-MULkVLfKGYDFYejP07QOurDLLQpcjk7Fw+7jXS2R2czRQzR56yHRveU5NDJEOviH+hETZKSkIk5c+T23GjFUMg==", - "requires": { - "brace-expansion": "^5.0.5" - } - }, - "semver": { - "version": "7.7.4", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.7.4.tgz", - "integrity": "sha512-vFKC2IEtQnVhpT78h1Yp8wzwrf8CM+MzKMHGJZfBtzhZNycRFnXsHk6E5TxIkkMsgNS7mdX3AGB7x2QM2di4lA==" - } - } - }, - "@redocly/cli-otel": { - "version": "0.1.2", - "resolved": "https://registry.npmjs.org/@redocly/cli-otel/-/cli-otel-0.1.2.tgz", - "integrity": "sha512-Bg7BoO5t1x3lVK+KhA5aGPmeXpQmdf6WtTYHhelKJCsQ+tRMiJoFAQoKHoBHAoNxXrhlS3K9lKFLHGmtxsFQfA==", - "requires": { - "ulid": "^2.3.0" - }, - "dependencies": { - "ulid": { - "version": "2.4.0", - "resolved": "https://registry.npmjs.org/ulid/-/ulid-2.4.0.tgz", - "integrity": "sha512-fIRiVTJNcSRmXKPZtGzFQv9WRrZ3M9eoptl/teFJvjOzmpU+/K/JH6HZ8deBfb5vMEpicJcLn7JmvdknlMq7Zg==" - } - } - }, - "@redocly/config": { - "version": "0.45.0", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.45.0.tgz", - "integrity": "sha512-V+wNusPQUaYV1c5s9iptfKQ2Ggno4bMeiyXdNILxqZS87gttwPfqlqHKHKFyz006voS3JsR295cbpx3GlsIxKg==", - "requires": { - "json-schema-to-ts": "2.7.2" - } - }, - "@redocly/openapi-core": { - "version": "2.25.3", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-2.25.3.tgz", - "integrity": "sha512-GIu3Mdym5IDIPCvXTzMZ6TQw/+7sKd52PdysxNVe7zBk22ExSGnVE9UAk9BaLOzXT77PJWDUwaimBdJoPpxHMA==", - "requires": { - "@redocly/ajv": "^8.18.0", - "@redocly/config": "^0.45.0", - "ajv": "npm:@redocly/ajv@8.18.0", - "ajv-formats": "^3.0.1", - "colorette": "^1.2.0", - "js-levenshtein": "^1.1.6", - "js-yaml": "^4.1.0", - "picomatch": "^4.0.4", - "pluralize": "^8.0.0", - "yaml-ast-parser": "0.0.43" - } - }, - "@redocly/respect-core": { - "version": "2.25.3", - "resolved": "https://registry.npmjs.org/@redocly/respect-core/-/respect-core-2.25.3.tgz", - "integrity": "sha512-07m80JYdp7J7kH4D1Vqdpa2ZBFCv3QAwCoh2w9H3OjuT/rXQkBSkJQm1n70fzO/HuUf4azzULdp2XnsIpxP2qw==", - "requires": { - "@faker-js/faker": "^7.6.0", - "@noble/hashes": "^1.8.0", - "@redocly/ajv": "^8.18.0", - "@redocly/openapi-core": "2.25.3", - "ajv": "npm:@redocly/ajv@8.18.0", - "better-ajv-errors": "^1.2.0", - "colorette": "^2.0.20", - "json-pointer": "^0.6.2", - "jsonpath-rfc9535": "1.3.0", - "openapi-sampler": "^1.7.1", - "outdent": "^0.8.0", - "picomatch": "^4.0.4" - }, - "dependencies": { - "colorette": { - "version": "2.0.20", - "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz", - "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==" - } - } - }, - "@types/json-schema": { - "version": "7.0.15", - "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz", - "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==" - }, - "@types/node": { - "version": "25.5.0", - "resolved": "https://registry.npmjs.org/@types/node/-/node-25.5.0.tgz", - "integrity": "sha512-jp2P3tQMSxWugkCUKLRPVUpGaL5MVFwF8RDuSRztfwgN1wmqJeMSbKlnEtQqU8UrhTmzEmZdu2I6v2dpp7XIxw==", - "requires": { - "undici-types": "~7.18.0" - } - }, - "@types/stylis": { - "version": "4.2.7", - "resolved": "https://registry.npmjs.org/@types/stylis/-/stylis-4.2.7.tgz", - "integrity": "sha512-VgDNokpBoKF+wrdvhAAfS55OMQpL6QRglwTwNC3kIgBrzZxA4WsFj+2eLfEA/uMUDzBcEhYmjSbwQakn/i3ajA==" - }, - "@types/trusted-types": { - "version": "2.0.7", - "resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz", - "integrity": "sha512-ScaPdn1dQczgbl0QFTeTOmVHFULt394XJgOQNoyVhZ6r2vLnMLJfBPd53SB52T/3G36VI1/g2MZaX0cwDuXsfw==", - "optional": true - }, - "abbrev": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/abbrev/-/abbrev-1.1.1.tgz", - "integrity": "sha512-nne9/IiQ/hzIhY6pdDnbBtz7DjPTKrY00P/zvPSm5pOFkl6xuGrGnXn/VtTNNfNtAfZ9/1RtehkszU9qcTii0Q==", - "dev": true - }, - "abort-controller": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz", - "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==", - "requires": { - "event-target-shim": "^5.0.0" - } - }, - "agent-base": { - "version": "7.1.4", - "resolved": "https://registry.npmjs.org/agent-base/-/agent-base-7.1.4.tgz", - "integrity": "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ==" - }, - "ajv": { - "version": "npm:@redocly/ajv@8.18.0", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.18.0.tgz", - "integrity": "sha512-F+LMD2IDIXuHxgpLJh3nkLj9+tSaEzoUWd+7fONGq5pe2169FUDjpEkOfEpoGLz1sbZni/69p07OsecNfAOpqA==", - "requires": { - "fast-deep-equal": "^3.1.3", - "fast-uri": "^3.0.1", - "json-schema-traverse": "^1.0.0", - "require-from-string": "^2.0.2" - } - }, - "ajv-formats": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/ajv-formats/-/ajv-formats-3.0.1.tgz", - "integrity": "sha512-8iUql50EUR+uUcdRQ3HDqa6EVyo3docL8g5WJ3FNcWmu62IbkGUue/pEyLBW8VGKKucTPgqeks4fIU1DA4yowQ==", - "requires": { - "ajv": "^8.0.0" - } - }, - "ansi-regex": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-5.0.1.tgz", - "integrity": "sha512-quJQXlTSUGL2LH9SUXo8VwsY4soanhgo6LNSm84E1LBcE8s3O0wpdiRzyR9z/ZZJMlMWv37qOOb9pdJlMUEKFQ==" - }, - "ansi-styles": { - "version": "3.2.1", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-3.2.1.tgz", - "integrity": "sha512-VT0ZI6kZRdTh8YyJw3SMbYm/u+NqfsAxEpWO0Pf9sq8/e94WxxOpPKx9FR1FlyCtOVDNOQ+8ntlqFxiRc+r5qA==", - "dev": true, - "requires": { - "color-convert": "^1.9.0" - } - }, - "argparse": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/argparse/-/argparse-2.0.1.tgz", - "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==" - }, - "array-find-index": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/array-find-index/-/array-find-index-1.0.2.tgz", - "integrity": "sha1-3wEKoSh+Fku9pvlyOwqWoexBh6E=", - "dev": true - }, - "asap": { - "version": "2.0.6", - "resolved": "https://registry.npmjs.org/asap/-/asap-2.0.6.tgz", - "integrity": "sha1-5QNHYR1+aQlDIIu9r+vLwvuGbUY=", - "dev": true - }, - "balanced-match": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/balanced-match/-/balanced-match-1.0.2.tgz", - "integrity": "sha512-3oSeUO0TMV67hN1AmbXsK4yaqU7tjiHlbxRDZOpH0KW9+CeX4bRAaX0Anxt0tx2MrpRpWwQaPwIlISEJhYU5Pw==" - }, - "better-ajv-errors": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/better-ajv-errors/-/better-ajv-errors-1.2.0.tgz", - "integrity": "sha512-UW+IsFycygIo7bclP9h5ugkNH8EjCSgqyFB/yQ4Hqqa1OEYDtb0uFIkYE0b6+CjkgJYVM5UKI/pJPxjYe9EZlA==", - "requires": { - "@babel/code-frame": "^7.16.0", - "@humanwhocodes/momoa": "^2.0.2", - "chalk": "^4.1.2", - "jsonpointer": "^5.0.0", - "leven": "^3.1.0 < 4" - }, - "dependencies": { - "ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "requires": { - "color-convert": "^2.0.1" - } - }, - "chalk": { - "version": "4.1.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", - "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", - "requires": { - "ansi-styles": "^4.1.0", - "supports-color": "^7.1.0" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" - }, - "has-flag": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", - "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==" - }, - "supports-color": { - "version": "7.2.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", - "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", - "requires": { - "has-flag": "^4.0.0" - } - } - } - }, - "brace-expansion": { - "version": "1.1.14", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", - "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", - "dev": true, - "requires": { - "balanced-match": "^1.0.0", - "concat-map": "0.0.1" - } - }, - "call-me-maybe": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/call-me-maybe/-/call-me-maybe-1.0.2.tgz", - "integrity": "sha512-HpX65o1Hnr9HH25ojC1YGs7HCQLq0GCOibSaWER0eNpgJ/Z1MZv2mTc7+xh6WOPxbRVcmgbv4hGU+uSQ/2xFZQ==" - }, - "camelize": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/camelize/-/camelize-1.0.1.tgz", - "integrity": "sha512-dU+Tx2fsypxTgtLoE36npi3UqcjSSMNYfkqgmoEhtZrraP5VWq0K7FkWVTYa8eMPtnU/G2txVsfdCJTn9uzpuQ==" - }, - "chalk": { - "version": "2.4.2", - "resolved": "https://registry.npmjs.org/chalk/-/chalk-2.4.2.tgz", - "integrity": "sha512-Mti+f9lpJNcwF4tWV8/OrTTtF1gZi+f8FqlyAdouralcFWFQWF2+NgCHShjkCb+IFBLq9buZwE1xckQU4peSuQ==", - "dev": true, - "requires": { - "ansi-styles": "^3.2.1", - "escape-string-regexp": "^1.0.5", - "supports-color": "^5.3.0" - } - }, - "classnames": { - "version": "2.5.1", - "resolved": "https://registry.npmjs.org/classnames/-/classnames-2.5.1.tgz", - "integrity": "sha512-saHYOzhIQs6wy2sVxTM6bUDsQO4F50V9RQ22qBpEdCW+I+/Wmke2HOl6lS6dTpdxVhb88/I6+Hs+438c3lfUow==" - }, - "cliui": { - "version": "7.0.4", - "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz", - "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==", - "requires": { - "string-width": "^4.2.0", - "strip-ansi": "^6.0.0", - "wrap-ansi": "^7.0.0" - } - }, - "clsx": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/clsx/-/clsx-2.1.1.tgz", - "integrity": "sha512-eYm0QWBtUrBWZWG0d386OGAw16Z995PiOVo2B7bjWSbHedGl5e0ZWaq65kOGgUSNesEIDkB9ISbTg/JK9dhCZA==" - }, - "color-convert": { - "version": "1.9.3", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-1.9.3.tgz", - "integrity": "sha512-QfAUtd+vFdAtFQcC8CCyYt1fYWxSqAiK2cSD6zDB8N3cpsEBAvRxp9zOGg6G/SHHJYAT88/az/IuDGALsNVbGg==", - "dev": true, - "requires": { - "color-name": "1.1.3" - } - }, - "color-name": { - "version": "1.1.3", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.3.tgz", - "integrity": "sha1-p9BVi9icQveV3UIyj3QIMcpTvCU=", - "dev": true - }, - "colorette": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/colorette/-/colorette-1.4.0.tgz", - "integrity": "sha512-Y2oEozpomLn7Q3HFP7dpww7AtMJplbM9lGZP6RDfHqmbeRjiwRg4n6VM6j4KLmRke85uWEI7JqF17f3pqdRA0g==" - }, - "concat-map": { - "version": "0.0.1", - "resolved": "https://registry.npmjs.org/concat-map/-/concat-map-0.0.1.tgz", - "integrity": "sha1-2Klr13/Wjfd5OnMDajug1UBdR3s=", - "dev": true - }, - "cookie": { - "version": "0.7.2", - "resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz", - "integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==" - }, - "core-js": { - "version": "3.49.0", - "resolved": "https://registry.npmjs.org/core-js/-/core-js-3.49.0.tgz", - "integrity": "sha512-es1U2+YTtzpwkxVLwAFdSpaIMyQaq0PBgm3YD1W3Qpsn1NAmO3KSgZfu+oGSWVu6NvLHoHCV/aYcsE5wiB7ALg==", - "peer": true - }, - "css-color-keywords": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/css-color-keywords/-/css-color-keywords-1.0.0.tgz", - "integrity": "sha512-FyyrDHZKEjXDpNJYvVsV960FiqQyXc/LlYmsxl2BcdMb2WPx0OGRVgTg55rPSyLSNMqP52R9r8geSp7apN3Ofg==" - }, - "css-to-react-native": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/css-to-react-native/-/css-to-react-native-3.2.0.tgz", - "integrity": "sha512-e8RKaLXMOFii+02mOlqwjbD00KSEKqblnpO9e++1aXS1fPQOpS1YoqdVHBqPjHNoxeF2mimzVqawm2KCbEdtHQ==", - "requires": { - "camelize": "^1.0.0", - "css-color-keywords": "^1.0.0", - "postcss-value-parser": "^4.0.2" - } - }, - "csstype": { - "version": "3.2.3", - "resolved": "https://registry.npmjs.org/csstype/-/csstype-3.2.3.tgz", - "integrity": "sha512-z1HGKcYy2xA8AGQfwrn0PAy+PB7X/GSj3UVJW9qKyn43xWa+gl5nXmU4qqLMRzWVLFC8KusUX8T/0kCiOYpAIQ==" - }, - "debug": { - "version": "4.4.3", - "resolved": "https://registry.npmjs.org/debug/-/debug-4.4.3.tgz", - "integrity": "sha512-RGwwWnwQvkVfavKVt22FGLw+xYSdzARwm0ru6DhTVA3umU5hZc28V3kO4stgYryrTlLpuvgI9GiijltAjNbcqA==", - "requires": { - "ms": "^2.1.3" - } - }, - "debuglog": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/debuglog/-/debuglog-1.0.1.tgz", - "integrity": "sha1-qiT/uaw9+aI1GDfPstJ5NgzXhJI=", - "dev": true - }, - "decko": { - "version": "1.2.0", - "resolved": "https://registry.npmjs.org/decko/-/decko-1.2.0.tgz", - "integrity": "sha512-m8FnyHXV1QX+S1cl+KPFDIl6NMkxtKsy6+U/aYyjrOqWMuwAwYWu7ePqrsUHtDR5Y8Yk2pi/KIDSgF+vT4cPOQ==" - }, - "dezalgo": { - "version": "1.0.4", - "resolved": "https://registry.npmjs.org/dezalgo/-/dezalgo-1.0.4.tgz", - "integrity": "sha512-rXSP0bf+5n0Qonsb+SVVfNfIsimO4HEtmnIpPHY8Q1UCzKlQrDMfdobr8nJOOsRgWCyMRqeSBQzmWUMq7zvVig==", - "dev": true, - "requires": { - "asap": "^2.0.0", - "wrappy": "1" - } - }, - "dompurify": { - "version": "3.3.3", - "resolved": "https://registry.npmjs.org/dompurify/-/dompurify-3.3.3.tgz", - "integrity": "sha512-Oj6pzI2+RqBfFG+qOaOLbFXLQ90ARpcGG6UePL82bJLtdsa6CYJD7nmiU8MW9nQNOtCHV3lZ/Bzq1X0QYbBZCA==", - "requires": { - "@types/trusted-types": "^2.0.7" - } - }, - "dotenv": { - "version": "16.4.7", - "resolved": "https://registry.npmjs.org/dotenv/-/dotenv-16.4.7.tgz", - "integrity": "sha512-47qPchRCykZC03FhkYAhrvwU4xDBFIj1QPqaarj6mdM/hgUzfPHcpkHJOn3mJAufFeeAxAzeGsr5X0M4k6fLZQ==" - }, - "emoji-regex": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", - "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==" - }, - "es6-promise": { - "version": "3.3.1", - "resolved": "https://registry.npmjs.org/es6-promise/-/es6-promise-3.3.1.tgz", - "integrity": "sha512-SOp9Phqvqn7jtEUxPWdWfWoLmyt2VaJ6MpvP9Comy1MceMXqE6bxvaTu4iaxpYYPzhny28Lc+M87/c2cPK6lDg==" - }, - "escalade": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", - "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==" - }, - "escape-string-regexp": { - "version": "1.0.5", - "resolved": "https://registry.npmjs.org/escape-string-regexp/-/escape-string-regexp-1.0.5.tgz", - "integrity": "sha1-G2HAViGQqN/2rjuyzwIAyhMLhtQ=", - "dev": true - }, - "event-target-shim": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz", - "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==" - }, - "eventemitter3": { - "version": "5.0.4", - "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.4.tgz", - "integrity": "sha512-mlsTRyGaPBjPedk6Bvw+aqbsXDtoAyAzm5MO7JgU+yVRyMQ5O8bD4Kcci7BS85f93veegeCPkL8R4GLClnjLFw==" - }, - "fast-deep-equal": { - "version": "3.1.3", - "resolved": "https://registry.npmjs.org/fast-deep-equal/-/fast-deep-equal-3.1.3.tgz", - "integrity": "sha512-f3qQ9oQy9j2AhBe/H9VC91wLmKBCCU/gDOnKNAYG5hswO7BLKj09Hc5HYNz9cGI++xlpDCIgDaitVs03ATR84Q==" - }, - "fast-safe-stringify": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/fast-safe-stringify/-/fast-safe-stringify-2.1.1.tgz", - "integrity": "sha512-W+KJc2dmILlPplD/H4K9l9LcAHAfPtP6BY84uVLXQ6Evcz9Lcg33Y2z1IVblT6xdY54PXYVHEv+0Wpq8Io6zkA==" - }, - "fast-uri": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/fast-uri/-/fast-uri-3.1.0.tgz", - "integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==" - }, - "fast-xml-builder": { - "version": "1.1.5", - "resolved": "https://registry.npmjs.org/fast-xml-builder/-/fast-xml-builder-1.1.5.tgz", - "integrity": "sha512-4TJn/8FKLeslLAH3dnohXqE3QSoxkhvaMzepOIZytwJXZO69Bfz0HBdDHzOTOon6G59Zrk6VQ2bEiv1t61rfkA==", - "requires": { - "path-expression-matcher": "^1.1.3" - } - }, - "fast-xml-parser": { - "version": "5.7.2", - "resolved": "https://registry.npmjs.org/fast-xml-parser/-/fast-xml-parser-5.7.2.tgz", - "integrity": "sha512-P7oW7tLbYnhOLQk/Gv7cZgzgMPP/XN03K02/Jy6Y/NHzyIAIpxuZIM/YqAkfiXFPxA2CTm7NtCijK9EDu09u2w==", - "requires": { - "@nodable/entities": "^2.1.0", - "fast-xml-builder": "^1.1.5", - "path-expression-matcher": "^1.5.0", - "strnum": "^2.2.3" - } - }, - "foreach": { - "version": "2.0.6", - "resolved": "https://registry.npmjs.org/foreach/-/foreach-2.0.6.tgz", - "integrity": "sha512-k6GAGDyqLe9JaebCsFCoudPPWfihKu8pylYXRlqP1J7ms39iPoTtk2fviNglIeQEwdh0bQeKJ01ZPyuyQvKzwg==" - }, - "fs.realpath": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/fs.realpath/-/fs.realpath-1.0.0.tgz", - "integrity": "sha1-FQStJSMVjKpA20onh8sBQRmU6k8=", - "dev": true - }, - "function-bind": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz", - "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==", - "dev": true - }, - "get-caller-file": { - "version": "2.0.5", - "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", - "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==" - }, - "glob": { - "version": "7.2.3", - "resolved": "https://registry.npmjs.org/glob/-/glob-7.2.3.tgz", - "integrity": "sha512-nFR0zLpU2YCaRxwoCJvL6UvCH2JFyFVIvwTLsIf21AuHlMskA1hhTdk+LlYJtOlYt9v6dvszD2BGRqBL+iQK9Q==", - "dev": true, - "requires": { - "fs.realpath": "^1.0.0", - "inflight": "^1.0.4", - "inherits": "2", - "minimatch": "^3.1.1", - "once": "^1.3.0", - "path-is-absolute": "^1.0.0" - } - }, - "graceful-fs": { - "version": "4.2.11", - "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", - "integrity": "sha512-RbJ5/jmFcNNCcDV5o9eTnBLJ/HszWV0P73bc+Ff4nS/rJj+YaS6IGyiOL0VoBYX+l1Wrl3k63h/KrH+nhJ0XvQ==", - "dev": true - }, - "handlebars": { - "version": "4.7.9", - "resolved": "https://registry.npmjs.org/handlebars/-/handlebars-4.7.9.tgz", - "integrity": "sha512-4E71E0rpOaQuJR2A3xDZ+GM1HyWYv1clR58tC8emQNeQe3RH7MAzSbat+V0wG78LQBo6m6bzSG/L4pBuCsgnUQ==", - "requires": { - "minimist": "^1.2.5", - "neo-async": "^2.6.2", - "source-map": "^0.6.1", - "uglify-js": "^3.1.4", - "wordwrap": "^1.0.0" - } - }, - "has-flag": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-3.0.0.tgz", - "integrity": "sha1-tdRU3CGZriJWmfNGfloH87lVuv0=", - "dev": true - }, - "hasown": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", - "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", - "dev": true, - "requires": { - "function-bind": "^1.1.2" - } - }, - "hosted-git-info": { - "version": "2.8.9", - "resolved": "https://registry.npmjs.org/hosted-git-info/-/hosted-git-info-2.8.9.tgz", - "integrity": "sha512-mxIDAb9Lsm6DoOJ7xH+5+X4y1LU/4Hi50L9C5sIswK3JzULS4bwk1FvjdBgvYR4bzT4tuUQiC15FE2f5HbLvYw==", - "dev": true - }, - "http2-client": { - "version": "1.3.5", - "resolved": "https://registry.npmjs.org/http2-client/-/http2-client-1.3.5.tgz", - "integrity": "sha512-EC2utToWl4RKfs5zd36Mxq7nzHHBuomZboI0yYL6Y0RmBgT7Sgkq4rQ0ezFTYoIsSs7Tm9SJe+o2FcAg6GBhGA==" - }, - "https-proxy-agent": { - "version": "7.0.6", - "resolved": "https://registry.npmjs.org/https-proxy-agent/-/https-proxy-agent-7.0.6.tgz", - "integrity": "sha512-vK9P5/iUfdl95AI+JVyUuIcVtd4ofvtrOr3HNtM2yxC9bnMbEdp3x01OhQNnjb8IJYi38VlTE3mBXwcfvywuSw==", - "requires": { - "agent-base": "^7.1.2", - "debug": "4" - } - }, - "inflight": { - "version": "1.0.6", - "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", - "integrity": "sha1-Sb1jMdfQLQwJvJEKEHW6gWW1bfk=", - "dev": true, - "requires": { - "once": "^1.3.0", - "wrappy": "1" - } - }, - "inherits": { - "version": "2.0.4", - "resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz", - "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==" - }, - "is-core-module": { - "version": "2.16.1", - "resolved": "https://registry.npmjs.org/is-core-module/-/is-core-module-2.16.1.tgz", - "integrity": "sha512-UfoeMA6fIJ8wTYFEUjelnaGI67v6+N7qXJEvQuIGa99l4xsCruSYOVSQ0uPANn4dAzm8lkYPaKLrrijLq7x23w==", - "dev": true, - "requires": { - "hasown": "^2.0.2" - } - }, - "is-fullwidth-code-point": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", - "integrity": "sha512-zymm5+u+sCsSWyD9qNaejV3DFvhCKclKdizYaJUuHA83RLjb7nSuGnddCHGv0hk+KY7BMAlsWeK4Ueg6EV6XQg==" - }, - "js-levenshtein": { - "version": "1.1.6", - "resolved": "https://registry.npmjs.org/js-levenshtein/-/js-levenshtein-1.1.6.tgz", - "integrity": "sha512-X2BB11YZtrRqY4EnQcLX5Rh373zbK4alC1FW7D7MBhL2gtcC17cTnr6DmfHZeS0s2rTHjUTMMHfG7gO8SSdw+g==" - }, - "js-tokens": { - "version": "4.0.0", - "resolved": "https://registry.npmjs.org/js-tokens/-/js-tokens-4.0.0.tgz", - "integrity": "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ==" - }, - "js-yaml": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/js-yaml/-/js-yaml-4.1.1.tgz", - "integrity": "sha512-qQKT4zQxXl8lLwBtHMWwaTcGfFOZviOJet3Oy/xmGk2gZH677CJM9EvtfdSkgWcATZhj/55JZ0rmy3myCT5lsA==", - "requires": { - "argparse": "^2.0.1" - } - }, - "json-parse-even-better-errors": { - "version": "2.3.1", - "resolved": "https://registry.npmjs.org/json-parse-even-better-errors/-/json-parse-even-better-errors-2.3.1.tgz", - "integrity": "sha512-xyFwyhro/JEof6Ghe2iz2NcXoj2sloNsWr/XsERDK/oiPCfaNhl5ONfp+jQdAZRQQ0IJWNzH9zIZF7li91kh2w==", - "dev": true - }, - "json-pointer": { - "version": "0.6.2", - "resolved": "https://registry.npmjs.org/json-pointer/-/json-pointer-0.6.2.tgz", - "integrity": "sha512-vLWcKbOaXlO+jvRy4qNd+TI1QUPZzfJj1tpJ3vAXDych5XJf93ftpUKe5pKCrzyIIwgBJcOcCVRUfqQP25afBw==", - "requires": { - "foreach": "^2.0.4" - } - }, - "json-schema-to-ts": { - "version": "2.7.2", - "resolved": "https://registry.npmjs.org/json-schema-to-ts/-/json-schema-to-ts-2.7.2.tgz", - "integrity": "sha512-R1JfqKqbBR4qE8UyBR56Ms30LL62/nlhoz+1UkfI/VE7p54Awu919FZ6ZUPG8zIa3XB65usPJgr1ONVncUGSaQ==", - "requires": { - "@babel/runtime": "^7.18.3", - "@types/json-schema": "^7.0.9", - "ts-algebra": "^1.2.0" - } - }, - "json-schema-traverse": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/json-schema-traverse/-/json-schema-traverse-1.0.0.tgz", - "integrity": "sha512-NM8/P9n3XjXhIZn1lLhkFaACTOURQXjWhV4BA/RnOv8xvgqtqpAX9IO4mRQxSx1Rlo4tqzeqb0sOlruaOy3dug==" - }, - "jsonpath-rfc9535": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/jsonpath-rfc9535/-/jsonpath-rfc9535-1.3.0.tgz", - "integrity": "sha512-3jFHya7oZ45aDxIIdx+/zQARahHXxFSMWBkcBUldfXpLS9VCXDJyTKt35kQfEXLqh0K3Ixw/9xFnvcDStaxh7Q==" - }, - "jsonpointer": { - "version": "5.0.1", - "resolved": "https://registry.npmjs.org/jsonpointer/-/jsonpointer-5.0.1.tgz", - "integrity": "sha512-p/nXbhSEcu3pZRdkW1OfJhpsVtW1gd4Wa1fnQc9YLiTfAjn0312eMKimbdIQzuZl9aa9xUGaRlP9T/CJE/ditQ==" - }, - "leven": { - "version": "3.1.0", - "resolved": "https://registry.npmjs.org/leven/-/leven-3.1.0.tgz", - "integrity": "sha512-qsda+H8jTaUaN/x5vzW2rzc+8Rw4TAQ/4KjB46IwK5VH+IlVeeeje/EoZRpiXvIqjFgK84QffqPztGI3VBLG1A==" - }, - "license-checker": { - "version": "25.0.1", - "resolved": "https://registry.npmjs.org/license-checker/-/license-checker-25.0.1.tgz", - "integrity": "sha512-mET5AIwl7MR2IAKYYoVBBpV0OnkKQ1xGj2IMMeEFIs42QAkEVjRtFZGWmQ28WeU7MP779iAgOaOy93Mn44mn6g==", - "dev": true, - "requires": { - "chalk": "^2.4.1", - "debug": "^3.1.0", - "mkdirp": "^0.5.1", - "nopt": "^4.0.1", - "read-installed": "~4.0.3", - "semver": "^5.5.0", - "spdx-correct": "^3.0.0", - "spdx-expression-parse": "^3.0.0", - "spdx-satisfies": "^4.0.0", - "treeify": "^1.1.0" - }, - "dependencies": { - "debug": { - "version": "3.2.7", - "resolved": "https://registry.npmjs.org/debug/-/debug-3.2.7.tgz", - "integrity": "sha512-CFjzYYAi4ThfiQvizrFQevTTXHtnCqWfe7x1AhgEscTz6ZbLbfoLRLPugTQyBth6f8ZERVUSyWHFD/7Wu4t1XQ==", - "dev": true, - "requires": { - "ms": "^2.1.1" - } - } - } - }, - "long": { - "version": "5.3.2", - "resolved": "https://registry.npmjs.org/long/-/long-5.3.2.tgz", - "integrity": "sha512-mNAgZ1GmyNhD7AuqnTG3/VQ26o760+ZYBPKjPvugO8+nLbYfX6TVpJPseBvopbdY+qpZ/lKUnmEc1LeZYS3QAA==" - }, - "loose-envify": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/loose-envify/-/loose-envify-1.4.0.tgz", - "integrity": "sha512-lyuxPGr/Wfhrlem2CL/UcnUc1zcqKAImBDzukY7Y5F/yQiNdko6+fRLevlw1HgMySw7f611UIY408EtxRSoK3Q==", - "requires": { - "js-tokens": "^3.0.0 || ^4.0.0" - } - }, - "lru-cache": { - "version": "11.2.7", - "resolved": "https://registry.npmjs.org/lru-cache/-/lru-cache-11.2.7.tgz", - "integrity": "sha512-aY/R+aEsRelme17KGQa/1ZSIpLpNYYrhcrepKTZgE+W3WM16YMCaPwOHLHsmopZHELU0Ojin1lPVxKR0MihncA==" - }, - "lunr": { - "version": "2.3.9", - "resolved": "https://registry.npmjs.org/lunr/-/lunr-2.3.9.tgz", - "integrity": "sha512-zTU3DaZaF3Rt9rhN3uBMGQD3dD2/vFQqnvZCDv4dl5iOzq2IZQqTxu90r4E5J+nP70J3ilqVCrbho2eWaeW8Ow==" - }, - "mark.js": { - "version": "8.11.1", - "resolved": "https://registry.npmjs.org/mark.js/-/mark.js-8.11.1.tgz", - "integrity": "sha512-1I+1qpDt4idfgLQG+BNWmrqku+7/2bi5nLf4YwF8y8zXvmfiTBY3PV3ZibfrjBueCByROpuBjLLFCajqkgYoLQ==" - }, - "marked": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/marked/-/marked-4.3.0.tgz", - "integrity": "sha512-PRsaiG84bK+AMvxziE/lCFss8juXjNaWzVbN5tXAm4XjeaS9NAHhop+PjQxz2A9h8Q4M/xGmzP8vqNwy6JeK0A==" - }, - "minimatch": { - "version": "3.1.5", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-3.1.5.tgz", - "integrity": "sha512-VgjWUsnnT6n+NUk6eZq77zeFdpW2LWDzP6zFGrCbHXiYNul5Dzqk2HHQ5uFH2DNW5Xbp8+jVzaeNt94ssEEl4w==", - "dev": true, - "requires": { - "brace-expansion": "^1.1.7" - } - }, - "minimist": { - "version": "1.2.8", - "resolved": "https://registry.npmjs.org/minimist/-/minimist-1.2.8.tgz", - "integrity": "sha512-2yyAR8qBkN3YuheJanUpWC5U3bb5osDywNB8RzDVlDwDHbocAJveqqj1u8+SVD7jkWT4yvsHCpWqqWqAxb0zCA==" - }, - "minipass": { - "version": "7.1.3", - "resolved": "https://registry.npmjs.org/minipass/-/minipass-7.1.3.tgz", - "integrity": "sha512-tEBHqDnIoM/1rXME1zgka9g6Q2lcoCkxHLuc7ODJ5BxbP5d4c2Z5cGgtXAku59200Cx7diuHTOYfSBD8n6mm8A==" - }, - "mkdirp": { - "version": "0.5.6", - "resolved": "https://registry.npmjs.org/mkdirp/-/mkdirp-0.5.6.tgz", - "integrity": "sha512-FP+p8RB8OWpF3YZBCrP5gtADmtXApB5AMLn+vdyA+PyxCjrCs00mjyUozssO33cwDeT3wNGdLxJ5M//YqtHAJw==", - "dev": true, - "requires": { - "minimist": "^1.2.6" - } - }, - "mobx": { - "version": "6.15.0", - "resolved": "https://registry.npmjs.org/mobx/-/mobx-6.15.0.tgz", - "integrity": "sha512-UczzB+0nnwGotYSgllfARAqWCJ5e/skuV2K/l+Zyck/H6pJIhLXuBnz+6vn2i211o7DtbE78HQtsYEKICHGI+g==" - }, - "mobx-react": { - "version": "9.2.0", - "resolved": "https://registry.npmjs.org/mobx-react/-/mobx-react-9.2.0.tgz", - "integrity": "sha512-dkGWCx+S0/1mfiuFfHRH8D9cplmwhxOV5CkXMp38u6rQGG2Pv3FWYztS0M7ncR6TyPRQKaTG/pnitInoYE9Vrw==", - "requires": { - "mobx-react-lite": "^4.1.0" - } - }, - "mobx-react-lite": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/mobx-react-lite/-/mobx-react-lite-4.1.1.tgz", - "integrity": "sha512-iUxiMpsvNraCKXU+yPotsOncNNmyeS2B5DKL+TL6Tar/xm+wwNJAubJmtRSeAoYawdZqwv8Z/+5nPRHeQxTiXg==", - "requires": { - "use-sync-external-store": "^1.4.0" - } - }, - "ms": { - "version": "2.1.3", - "resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz", - "integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==" - }, - "nanoid": { - "version": "3.3.11", - "resolved": "https://registry.npmjs.org/nanoid/-/nanoid-3.3.11.tgz", - "integrity": "sha512-N8SpfPUnUp1bK+PMYW8qSWdl9U+wwNWI4QKxOYDy9JAro3WMX7p2OeVRF9v+347pnakNevPmiHhNmZ2HbFA76w==" - }, - "neo-async": { - "version": "2.6.2", - "resolved": "https://registry.npmjs.org/neo-async/-/neo-async-2.6.2.tgz", - "integrity": "sha512-Yd3UES5mWCSqR+qNT93S3UoYUkqAZ9lLg8a7g9rimsWmYGK8cVToA4/sF3RrshdyV3sAGMXVUmpMYOw+dLpOuw==" - }, - "node-fetch": { - "version": "2.7.0", - "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz", - "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==", - "requires": { - "whatwg-url": "^5.0.0" - } - }, - "node-fetch-h2": { - "version": "2.3.0", - "resolved": "https://registry.npmjs.org/node-fetch-h2/-/node-fetch-h2-2.3.0.tgz", - "integrity": "sha512-ofRW94Ab0T4AOh5Fk8t0h8OBWrmjb0SSB20xh1H8YnPV9EJ+f5AMoYSUQ2zgJ4Iq2HAK0I2l5/Nequ8YzFS3Hg==", - "requires": { - "http2-client": "^1.2.5" - } - }, - "node-readfiles": { - "version": "0.2.0", - "resolved": "https://registry.npmjs.org/node-readfiles/-/node-readfiles-0.2.0.tgz", - "integrity": "sha512-SU00ZarexNlE4Rjdm83vglt5Y9yiQ+XI1XpflWlb7q7UTN1JUItm69xMeiQCTxtTfnzt+83T8Cx+vI2ED++VDA==", - "requires": { - "es6-promise": "^3.2.1" - } - }, - "nopt": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/nopt/-/nopt-4.0.3.tgz", - "integrity": "sha512-CvaGwVMztSMJLOeXPrez7fyfObdZqNUK1cPAEzLHrTybIua9pMdmmPR5YwtfNftIOMv3DPUhFaxsZMNTQO20Kg==", - "dev": true, - "requires": { - "abbrev": "1", - "osenv": "^0.1.4" - } - }, - "normalize-package-data": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/normalize-package-data/-/normalize-package-data-2.5.0.tgz", - "integrity": "sha512-/5CMN3T0R4XTj4DcGaexo+roZSdSFW/0AOOTROrjxzCG1wrWXEsGbRKevjlIL+ZDE4sZlJr5ED4YW0yqmkK+eA==", - "dev": true, - "requires": { - "hosted-git-info": "^2.1.4", - "resolve": "^1.10.0", - "semver": "2 || 3 || 4 || 5", - "validate-npm-package-license": "^3.0.1" - } - }, - "npm-normalize-package-bin": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/npm-normalize-package-bin/-/npm-normalize-package-bin-1.0.1.tgz", - "integrity": "sha512-EPfafl6JL5/rU+ot6P3gRSCpPDW5VmIzX959Ob1+ySFUuuYHWHekXpwdUZcKP5C+DS4GEtdJluwBjnsNDl+fSA==", - "dev": true - }, - "oas-kit-common": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/oas-kit-common/-/oas-kit-common-1.0.8.tgz", - "integrity": "sha512-pJTS2+T0oGIwgjGpw7sIRU8RQMcUoKCDWFLdBqKB2BNmGpbBMH2sdqAaOXUg8OzonZHU0L7vfJu1mJFEiYDWOQ==", - "requires": { - "fast-safe-stringify": "^2.0.7" - } - }, - "oas-linter": { - "version": "3.2.2", - "resolved": "https://registry.npmjs.org/oas-linter/-/oas-linter-3.2.2.tgz", - "integrity": "sha512-KEGjPDVoU5K6swgo9hJVA/qYGlwfbFx+Kg2QB/kd7rzV5N8N5Mg6PlsoCMohVnQmo+pzJap/F610qTodKzecGQ==", - "requires": { - "@exodus/schemasafe": "^1.0.0-rc.2", - "should": "^13.2.1", - "yaml": "^1.10.0" - } - }, - "oas-resolver": { - "version": "2.5.6", - "resolved": "https://registry.npmjs.org/oas-resolver/-/oas-resolver-2.5.6.tgz", - "integrity": "sha512-Yx5PWQNZomfEhPPOphFbZKi9W93CocQj18NlD2Pa4GWZzdZpSJvYwoiuurRI7m3SpcChrnO08hkuQDL3FGsVFQ==", - "requires": { - "node-fetch-h2": "^2.3.0", - "oas-kit-common": "^1.0.8", - "reftools": "^1.1.9", - "yaml": "^1.10.0", - "yargs": "^17.0.1" - } - }, - "oas-schema-walker": { - "version": "1.1.5", - "resolved": "https://registry.npmjs.org/oas-schema-walker/-/oas-schema-walker-1.1.5.tgz", - "integrity": "sha512-2yucenq1a9YPmeNExoUa9Qwrt9RFkjqaMAA1X+U7sbb0AqBeTIdMHky9SQQ6iN94bO5NW0W4TRYXerG+BdAvAQ==" - }, - "oas-validator": { - "version": "5.0.8", - "resolved": "https://registry.npmjs.org/oas-validator/-/oas-validator-5.0.8.tgz", - "integrity": "sha512-cu20/HE5N5HKqVygs3dt94eYJfBi0TsZvPVXDhbXQHiEityDN+RROTleefoKRKKJ9dFAF2JBkDHgvWj0sjKGmw==", - "requires": { - "call-me-maybe": "^1.0.1", - "oas-kit-common": "^1.0.8", - "oas-linter": "^3.2.2", - "oas-resolver": "^2.5.6", - "oas-schema-walker": "^1.1.5", - "reftools": "^1.1.9", - "should": "^13.2.1", - "yaml": "^1.10.0" - } - }, - "object-assign": { - "version": "4.1.1", - "resolved": "https://registry.npmjs.org/object-assign/-/object-assign-4.1.1.tgz", - "integrity": "sha512-rJgTQnkUnH1sFw8yT6VSU3zD3sWmu6sZhIseY8VX+GRu3P6F7Fu+JNDoXfklElbLJSnc3FUQHVe4cU5hj+BcUg==" - }, - "once": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/once/-/once-1.4.0.tgz", - "integrity": "sha1-WDsap3WWHUsROsF9nFC6753Xa9E=", - "dev": true, - "requires": { - "wrappy": "1" - } - }, - "openapi-sampler": { - "version": "1.7.2", - "resolved": "https://registry.npmjs.org/openapi-sampler/-/openapi-sampler-1.7.2.tgz", - "integrity": "sha512-OKytvqB5XIaTgA9xtw8W8UTar+uymW2xPVpFN0NihMtuHPdPTGxBEhGnfFnJW5g/gOSIvkP+H0Xh3XhVI9/n7g==", - "requires": { - "@types/json-schema": "^7.0.7", - "fast-xml-parser": "^5.5.1", - "json-pointer": "0.6.2" - } - }, - "os-homedir": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/os-homedir/-/os-homedir-1.0.2.tgz", - "integrity": "sha1-/7xJiDNuDoM94MFox+8VISGqf7M=", - "dev": true - }, - "os-tmpdir": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/os-tmpdir/-/os-tmpdir-1.0.2.tgz", - "integrity": "sha1-u+Z0BseaqFxc/sdm/lc0VV36EnQ=", - "dev": true - }, - "osenv": { - "version": "0.1.5", - "resolved": "https://registry.npmjs.org/osenv/-/osenv-0.1.5.tgz", - "integrity": "sha512-0CWcCECdMVc2Rw3U5w9ZjqX6ga6ubk1xDVKxtBQPK7wis/0F2r9T6k4ydGYhecl7YUBxBVxhL5oisPsNxAPe2g==", - "dev": true, - "requires": { - "os-homedir": "^1.0.0", - "os-tmpdir": "^1.0.0" - } - }, - "outdent": { - "version": "0.8.0", - "resolved": "https://registry.npmjs.org/outdent/-/outdent-0.8.0.tgz", - "integrity": "sha512-KiOAIsdpUTcAXuykya5fnVVT+/5uS0Q1mrkRHcF89tpieSmY33O/tmc54CqwA+bfhbtEfZUNLHaPUiB9X3jt1A==" - }, - "path-browserify": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/path-browserify/-/path-browserify-1.0.1.tgz", - "integrity": "sha512-b7uo2UCUOYZcnF/3ID0lulOJi/bafxa1xPe7ZPsammBSpjSWQkjNxlt635YGS2MiR9GjvuXCtz2emr3jbsz98g==" - }, - "path-expression-matcher": { - "version": "1.5.0", - "resolved": "https://registry.npmjs.org/path-expression-matcher/-/path-expression-matcher-1.5.0.tgz", - "integrity": "sha512-cbrerZV+6rvdQrrD+iGMcZFEiiSrbv9Tfdkvnusy6y0x0GKBXREFg/Y65GhIfm0tnLntThhzCnfKwp1WRjeCyQ==" - }, - "path-is-absolute": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/path-is-absolute/-/path-is-absolute-1.0.1.tgz", - "integrity": "sha1-F0uSaHNVNP+8es5r9TpanhtcX18=", - "dev": true - }, - "path-parse": { - "version": "1.0.7", - "resolved": "https://registry.npmjs.org/path-parse/-/path-parse-1.0.7.tgz", - "integrity": "sha512-LDJzPVEEEPR+y48z93A0Ed0yXb8pAByGWo/k5YYdYgpY2/2EsOsksJrq7lOHxryrVOn1ejG6oAp8ahvOIQD8sw==", - "dev": true - }, - "path-scurry": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/path-scurry/-/path-scurry-2.0.2.tgz", - "integrity": "sha512-3O/iVVsJAPsOnpwWIeD+d6z/7PmqApyQePUtCndjatj/9I5LylHvt5qluFaBT3I5h3r1ejfR056c+FCv+NnNXg==", - "requires": { - "lru-cache": "^11.0.0", - "minipass": "^7.1.2" - } - }, - "perfect-scrollbar": { - "version": "1.5.6", - "resolved": "https://registry.npmjs.org/perfect-scrollbar/-/perfect-scrollbar-1.5.6.tgz", - "integrity": "sha512-rixgxw3SxyJbCaSpo1n35A/fwI1r2rdwMKOTCg/AcG+xOEyZcE8UHVjpZMFCVImzsFoCZeJTT+M/rdEIQYO2nw==" - }, - "picocolors": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/picocolors/-/picocolors-1.1.1.tgz", - "integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==" - }, - "picomatch": { - "version": "4.0.4", - "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-4.0.4.tgz", - "integrity": "sha512-QP88BAKvMam/3NxH6vj2o21R6MjxZUAd6nlwAS/pnGvN9IVLocLHxGYIzFhg6fUQ+5th6P4dv4eW9jX3DSIj7A==" - }, - "pluralize": { - "version": "8.0.0", - "resolved": "https://registry.npmjs.org/pluralize/-/pluralize-8.0.0.tgz", - "integrity": "sha512-Nc3IT5yHzflTfbjgqWcCPpo7DaKy4FnpB0l/zCAW0Tc7jxAiuqSxHasntB3D7887LSrA93kDJ9IXovxJYxyLCA==" - }, - "polished": { - "version": "4.3.1", - "resolved": "https://registry.npmjs.org/polished/-/polished-4.3.1.tgz", - "integrity": "sha512-OBatVyC/N7SCW/FaDHrSd+vn0o5cS855TOmYi4OkdWUMSJCET/xip//ch8xGUvtr3i44X9LVyWwQlRMTN3pwSA==", - "requires": { - "@babel/runtime": "^7.17.8" - } - }, - "postcss": { - "version": "8.4.49", - "resolved": "https://registry.npmjs.org/postcss/-/postcss-8.4.49.tgz", - "integrity": "sha512-OCVPnIObs4N29kxTjzLfUryOkvZEq+pf8jTF0lg8E7uETuWHA+v7j3c/xJmiqpX450191LlmZfUKkXxkTry7nA==", - "requires": { - "nanoid": "^3.3.7", - "picocolors": "^1.1.1", - "source-map-js": "^1.2.1" - } - }, - "postcss-value-parser": { - "version": "4.2.0", - "resolved": "https://registry.npmjs.org/postcss-value-parser/-/postcss-value-parser-4.2.0.tgz", - "integrity": "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ==" - }, - "prismjs": { - "version": "1.30.0", - "resolved": "https://registry.npmjs.org/prismjs/-/prismjs-1.30.0.tgz", - "integrity": "sha512-DEvV2ZF2r2/63V+tK8hQvrR2ZGn10srHbXviTlcv7Kpzw8jWiNTqbVgjO3IY8RxrrOUF8VPMQQFysYYYv0YZxw==" - }, - "prop-types": { - "version": "15.8.1", - "resolved": "https://registry.npmjs.org/prop-types/-/prop-types-15.8.1.tgz", - "integrity": "sha512-oj87CgZICdulUohogVAR7AjlC0327U4el4L6eAvOqCeudMDVU0NThNaV+b9Df4dXgSP1gXMTnPdhfe/2qDH5cg==", - "requires": { - "loose-envify": "^1.4.0", - "object-assign": "^4.1.1", - "react-is": "^16.13.1" - } - }, - "protobufjs": { - "version": "7.5.8", - "resolved": "https://registry.npmjs.org/protobufjs/-/protobufjs-7.5.8.tgz", - "integrity": "sha512-dvpCIeLPbXZS/Ete7yLaO7RenOdken2NHKykBXbsaGxZT0UTltcarBciw+A78SRQs9iMAAVpsYA+l8b1hTePIA==", - "requires": { - "@protobufjs/aspromise": "^1.1.2", - "@protobufjs/base64": "^1.1.2", - "@protobufjs/codegen": "^2.0.5", - "@protobufjs/eventemitter": "^1.1.0", - "@protobufjs/fetch": "^1.1.0", - "@protobufjs/float": "^1.0.2", - "@protobufjs/inquire": "^1.1.1", - "@protobufjs/path": "^1.1.2", - "@protobufjs/pool": "^1.1.0", - "@protobufjs/utf8": "^1.1.1", - "@types/node": ">=13.7.0", - "long": "^5.0.0" - } - }, - "queue-microtask": { - "version": "1.2.3", - "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", - "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==" - }, - "randombytes": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/randombytes/-/randombytes-2.1.0.tgz", - "integrity": "sha512-vYl3iOX+4CKUWuxGi9Ukhie6fsqXqS9FE2Zaic4tNFD2N2QQaXOMFbuKK4QmDHC0JO6B1Zp41J0LpT0oR68amQ==", - "requires": { - "safe-buffer": "^5.1.0" - } - }, - "react": { - "version": "19.2.4", - "resolved": "https://registry.npmjs.org/react/-/react-19.2.4.tgz", - "integrity": "sha512-9nfp2hYpCwOjAN+8TZFGhtWEwgvWHXqESH8qT89AT/lWklpLON22Lc8pEtnpsZz7VmawabSU0gCjnj8aC0euHQ==" - }, - "react-dom": { - "version": "19.2.4", - "resolved": "https://registry.npmjs.org/react-dom/-/react-dom-19.2.4.tgz", - "integrity": "sha512-AXJdLo8kgMbimY95O2aKQqsz2iWi9jMgKJhRBAxECE4IFxfcazB2LmzloIoibJI3C12IlY20+KFaLv+71bUJeQ==", - "requires": { - "scheduler": "^0.27.0" - } - }, - "react-is": { - "version": "16.13.1", - "resolved": "https://registry.npmjs.org/react-is/-/react-is-16.13.1.tgz", - "integrity": "sha512-24e6ynE2H+OKt4kqsOvNd8kBpV65zoxbA4BVsEOB3ARVWQki/DHzaUoC5KuON/BiccDaCCTZBuOcfZs70kR8bQ==" - }, - "react-tabs": { - "version": "6.1.1", - "resolved": "https://registry.npmjs.org/react-tabs/-/react-tabs-6.1.1.tgz", - "integrity": "sha512-CPiuKoMFf89B7QlbFfdBD9XmUWiE3qudQputMVZB8GQvPJZRX/gqjDaDWOPDwGinEfpJKEuBCkGt83Tt4efeyA==", - "requires": { - "clsx": "^2.0.0", - "prop-types": "^15.5.0" - } - }, - "read-installed": { - "version": "4.0.3", - "resolved": "https://registry.npmjs.org/read-installed/-/read-installed-4.0.3.tgz", - "integrity": "sha1-/5uLZ/GH0eTCm5/rMfayI6zRkGc=", - "dev": true, - "requires": { - "debuglog": "^1.0.1", - "graceful-fs": "^4.1.2", - "read-package-json": "^2.0.0", - "readdir-scoped-modules": "^1.0.0", - "semver": "2 || 3 || 4 || 5", - "slide": "~1.1.3", - "util-extend": "^1.0.1" - } - }, - "read-package-json": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/read-package-json/-/read-package-json-2.1.2.tgz", - "integrity": "sha512-D1KmuLQr6ZSJS0tW8hf3WGpRlwszJOXZ3E8Yd/DNRaM5d+1wVRZdHlpGBLAuovjr28LbWvjpWkBHMxpRGGjzNA==", - "dev": true, - "requires": { - "glob": "^7.1.1", - "json-parse-even-better-errors": "^2.3.0", - "normalize-package-data": "^2.0.0", - "npm-normalize-package-bin": "^1.0.0" - } - }, - "readable-stream": { - "version": "3.6.2", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", - "integrity": "sha512-9u/sniCrY3D5WdsERHzHE4G2YCXqoG5FTHUiCC4SIbr6XcLZBY05ya9EKjYek9O5xOAwjGq+1JdGBAS7Q9ScoA==", - "requires": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - } - }, - "readdir-scoped-modules": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/readdir-scoped-modules/-/readdir-scoped-modules-1.1.0.tgz", - "integrity": "sha512-asaikDeqAQg7JifRsZn1NJZXo9E+VwlyCfbkZhwyISinqk5zNS6266HS5kah6P0SaQKGF6SkNnZVHUzHFYxYDw==", - "dev": true, - "requires": { - "debuglog": "^1.0.1", - "dezalgo": "^1.0.0", - "graceful-fs": "^4.1.2", - "once": "^1.3.0" - } - }, - "redoc": { - "version": "2.5.1", - "resolved": "https://registry.npmjs.org/redoc/-/redoc-2.5.1.tgz", - "integrity": "sha512-LmqA+4A3CmhTllGG197F0arUpmChukAj9klfSdxNRemT9Hr07xXr7OGKu4PHzBs359sgrJ+4JwmOlM7nxLPGMg==", - "requires": { - "@redocly/openapi-core": "^1.4.0", - "classnames": "^2.3.2", - "decko": "^1.2.0", - "dompurify": "^3.2.4", - "eventemitter3": "^5.0.1", - "json-pointer": "^0.6.2", - "lunr": "^2.3.9", - "mark.js": "^8.11.1", - "marked": "^4.3.0", - "mobx-react": "9.2.0", - "openapi-sampler": "^1.5.0", - "path-browserify": "^1.0.1", - "perfect-scrollbar": "^1.5.5", - "polished": "^4.2.2", - "prismjs": "^1.29.0", - "prop-types": "^15.8.1", - "react-tabs": "^6.0.2", - "slugify": "~1.4.7", - "stickyfill": "^1.1.1", - "swagger2openapi": "^7.0.8", - "url-template": "^2.0.8" - }, - "dependencies": { - "@redocly/ajv": { - "version": "8.11.2", - "resolved": "https://registry.npmjs.org/@redocly/ajv/-/ajv-8.11.2.tgz", - "integrity": "sha512-io1JpnwtIcvojV7QKDUSIuMN/ikdOUd1ReEnUnMKGfDVridQZ31J0MmIuqwuRjWDZfmvr+Q0MqCcfHM2gTivOg==", - "requires": { - "fast-deep-equal": "^3.1.1", - "json-schema-traverse": "^1.0.0", - "require-from-string": "^2.0.2", - "uri-js-replace": "^1.0.1" - } - }, - "@redocly/config": { - "version": "0.22.0", - "resolved": "https://registry.npmjs.org/@redocly/config/-/config-0.22.0.tgz", - "integrity": "sha512-gAy93Ddo01Z3bHuVdPWfCwzgfaYgMdaZPcfL7JZ7hWJoK9V0lXDbigTWkhiPFAaLWzbOJ+kbUQG1+XwIm0KRGQ==" - }, - "@redocly/openapi-core": { - "version": "1.34.11", - "resolved": "https://registry.npmjs.org/@redocly/openapi-core/-/openapi-core-1.34.11.tgz", - "integrity": "sha512-V09ayfnb5GyysmvARbt+voFZAjGcf7hSYxOYxSkCc4fbH/DTfq5YWoec8cflvmHHqyIFbqvmGKmYFzqhr9zxDg==", - "requires": { - "@redocly/ajv": "8.11.2", - "@redocly/config": "0.22.0", - "colorette": "1.4.0", - "https-proxy-agent": "7.0.6", - "js-levenshtein": "1.1.6", - "js-yaml": "4.1.1", - "minimatch": "5.1.9", - "pluralize": "8.0.0", - "yaml-ast-parser": "0.0.43" - } - }, - "brace-expansion": { - "version": "2.1.0", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-2.1.0.tgz", - "integrity": "sha512-TN1kCZAgdgweJhWWpgKYrQaMNHcDULHkWwQIspdtjV4Y5aurRdZpjAqn6yX3FPqTA9ngHCc4hJxMAMgGfve85w==", - "requires": { - "balanced-match": "^1.0.0" - } - }, - "minimatch": { - "version": "5.1.9", - "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.9.tgz", - "integrity": "sha512-7o1wEA2RyMP7Iu7GNba9vc0RWWGACJOCZBJX2GJWip0ikV+wcOsgVuY9uE8CPiyQhkGFSlhuSkZPavN7u1c2Fw==", - "requires": { - "brace-expansion": "^2.0.1" - } - } - } - }, - "reftools": { - "version": "1.1.9", - "resolved": "https://registry.npmjs.org/reftools/-/reftools-1.1.9.tgz", - "integrity": "sha512-OVede/NQE13xBQ+ob5CKd5KyeJYU2YInb1bmV4nRoOfquZPkAkxuOXicSe1PvqIuZZ4kD13sPKBbR7UFDmli6w==" - }, - "require-directory": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", - "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==" - }, - "require-from-string": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/require-from-string/-/require-from-string-2.0.2.tgz", - "integrity": "sha512-Xf0nWe6RseziFMu+Ap9biiUbmplq6S9/p+7w7YXP/JBHhrUDDUhwa+vANyubuqfZWTveU//DYVGsDG7RKL/vEw==" - }, - "resolve": { - "version": "1.22.11", - "resolved": "https://registry.npmjs.org/resolve/-/resolve-1.22.11.tgz", - "integrity": "sha512-RfqAvLnMl313r7c9oclB1HhUEAezcpLjz95wFH4LVuhk9JF/r22qmVP9AMmOU4vMX7Q8pN8jwNg/CSpdFnMjTQ==", - "dev": true, - "requires": { - "is-core-module": "^2.16.1", - "path-parse": "^1.0.7", - "supports-preserve-symlinks-flag": "^1.0.0" - } - }, - "safe-buffer": { - "version": "5.2.1", - "resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz", - "integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==" - }, - "scheduler": { - "version": "0.27.0", - "resolved": "https://registry.npmjs.org/scheduler/-/scheduler-0.27.0.tgz", - "integrity": "sha512-eNv+WrVbKu1f3vbYJT/xtiF5syA5HPIMtf9IgY/nKg0sWqzAUEvqY/xm7OcZc/qafLx/iO9FgOmeSAp4v5ti/Q==" - }, - "semver": { - "version": "5.7.2", - "resolved": "https://registry.npmjs.org/semver/-/semver-5.7.2.tgz", - "integrity": "sha512-cBznnQ9KjJqU67B52RMC65CMarK2600WFnbkcaiwWq3xy/5haFJlshgnpjovMVJ+Hff49d8GEn0b87C5pDQ10g==", - "dev": true - }, - "set-cookie-parser": { - "version": "2.7.2", - "resolved": "https://registry.npmjs.org/set-cookie-parser/-/set-cookie-parser-2.7.2.tgz", - "integrity": "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw==" - }, - "shallowequal": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/shallowequal/-/shallowequal-1.1.0.tgz", - "integrity": "sha512-y0m1JoUZSlPAjXVtPPW70aZWfIL/dSP7AFkRnniLCrK/8MDKog3TySTBmckD+RObVxH0v4Tox67+F14PdED2oQ==" - }, - "should": { - "version": "13.2.3", - "resolved": "https://registry.npmjs.org/should/-/should-13.2.3.tgz", - "integrity": "sha512-ggLesLtu2xp+ZxI+ysJTmNjh2U0TsC+rQ/pfED9bUZZ4DKefP27D+7YJVVTvKsmjLpIi9jAa7itwDGkDDmt1GQ==", - "requires": { - "should-equal": "^2.0.0", - "should-format": "^3.0.3", - "should-type": "^1.4.0", - "should-type-adaptors": "^1.0.1", - "should-util": "^1.0.0" - } - }, - "should-equal": { - "version": "2.0.0", - "resolved": "https://registry.npmjs.org/should-equal/-/should-equal-2.0.0.tgz", - "integrity": "sha512-ZP36TMrK9euEuWQYBig9W55WPC7uo37qzAEmbjHz4gfyuXrEUgF8cUvQVO+w+d3OMfPvSRQJ22lSm8MQJ43LTA==", - "requires": { - "should-type": "^1.4.0" - } - }, - "should-format": { - "version": "3.0.3", - "resolved": "https://registry.npmjs.org/should-format/-/should-format-3.0.3.tgz", - "integrity": "sha512-hZ58adtulAk0gKtua7QxevgUaXTTXxIi8t41L3zo9AHvjXO1/7sdLECuHeIN2SRtYXpNkmhoUP2pdeWgricQ+Q==", - "requires": { - "should-type": "^1.3.0", - "should-type-adaptors": "^1.0.1" - } - }, - "should-type": { - "version": "1.4.0", - "resolved": "https://registry.npmjs.org/should-type/-/should-type-1.4.0.tgz", - "integrity": "sha512-MdAsTu3n25yDbIe1NeN69G4n6mUnJGtSJHygX3+oN0ZbO3DTiATnf7XnYJdGT42JCXurTb1JI0qOBR65shvhPQ==" - }, - "should-type-adaptors": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/should-type-adaptors/-/should-type-adaptors-1.1.0.tgz", - "integrity": "sha512-JA4hdoLnN+kebEp2Vs8eBe9g7uy0zbRo+RMcU0EsNy+R+k049Ki+N5tT5Jagst2g7EAja+euFuoXFCa8vIklfA==", - "requires": { - "should-type": "^1.3.0", - "should-util": "^1.0.0" - } - }, - "should-util": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/should-util/-/should-util-1.0.1.tgz", - "integrity": "sha512-oXF8tfxx5cDk8r2kYqlkUJzZpDBqVY/II2WhvU0n9Y3XYvAYRmeaf1PvvIvTgPnv4KJ+ES5M0PyDq5Jp+Ygy2g==" - }, - "simple-websocket": { - "version": "9.1.0", - "resolved": "https://registry.npmjs.org/simple-websocket/-/simple-websocket-9.1.0.tgz", - "integrity": "sha512-8MJPnjRN6A8UCp1I+H/dSFyjwJhp6wta4hsVRhjf8w9qBHRzxYt14RaOcjvQnhD1N4yKOddEjflwMnQM4VtXjQ==", - "requires": { - "debug": "^4.3.1", - "queue-microtask": "^1.2.2", - "randombytes": "^2.1.0", - "readable-stream": "^3.6.0", - "ws": "^7.4.2" - } - }, - "slide": { - "version": "1.1.6", - "resolved": "https://registry.npmjs.org/slide/-/slide-1.1.6.tgz", - "integrity": "sha1-VusCfWW00tzmyy4tMsTUr8nh1wc=", - "dev": true - }, - "slugify": { - "version": "1.4.7", - "resolved": "https://registry.npmjs.org/slugify/-/slugify-1.4.7.tgz", - "integrity": "sha512-tf+h5W1IrjNm/9rKKj0JU2MDMruiopx0jjVA5zCdBtcGjfp0+c5rHw/zADLC3IeKlGHtVbHtpfzvYA0OYT+HKg==" - }, - "source-map": { - "version": "0.6.1", - "resolved": "https://registry.npmjs.org/source-map/-/source-map-0.6.1.tgz", - "integrity": "sha512-UjgapumWlbMhkBgzT7Ykc5YXUT46F0iKu8SGXq0bcwP5dz/h0Plj6enJqjz1Zbq2l5WaqYnrVbwWOWMyF3F47g==" - }, - "source-map-js": { - "version": "1.2.1", - "resolved": "https://registry.npmjs.org/source-map-js/-/source-map-js-1.2.1.tgz", - "integrity": "sha512-UXWMKhLOwVKb728IUtQPXxfYU+usdybtUrK/8uGE8CQMvrhOpwvzDBwj0QhSL7MQc7vIsISBG8VQ8+IDQxpfQA==" - }, - "spdx-compare": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/spdx-compare/-/spdx-compare-1.0.0.tgz", - "integrity": "sha512-C1mDZOX0hnu0ep9dfmuoi03+eOdDoz2yvK79RxbcrVEG1NO1Ph35yW102DHWKN4pk80nwCgeMmSY5L25VE4D9A==", - "dev": true, - "requires": { - "array-find-index": "^1.0.2", - "spdx-expression-parse": "^3.0.0", - "spdx-ranges": "^2.0.0" - } - }, - "spdx-correct": { - "version": "3.2.0", - "resolved": "https://registry.npmjs.org/spdx-correct/-/spdx-correct-3.2.0.tgz", - "integrity": "sha512-kN9dJbvnySHULIluDHy32WHRUu3Og7B9sbY7tsFLctQkIqnMh3hErYgdMjTYuqmcXX+lK5T1lnUt3G7zNswmZA==", - "dev": true, - "requires": { - "spdx-expression-parse": "^3.0.0", - "spdx-license-ids": "^3.0.0" - } - }, - "spdx-exceptions": { - "version": "2.5.0", - "resolved": "https://registry.npmjs.org/spdx-exceptions/-/spdx-exceptions-2.5.0.tgz", - "integrity": "sha512-PiU42r+xO4UbUS1buo3LPJkjlO7430Xn5SVAhdpzzsPHsjbYVflnnFdATgabnLude+Cqu25p6N+g2lw/PFsa4w==", - "dev": true - }, - "spdx-expression-parse": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/spdx-expression-parse/-/spdx-expression-parse-3.0.1.tgz", - "integrity": "sha512-cbqHunsQWnJNE6KhVSMsMeH5H/L9EpymbzqTQ3uLwNCLZ1Q481oWaofqH7nO6V07xlXwY6PhQdQ2IedWx/ZK4Q==", - "dev": true, - "requires": { - "spdx-exceptions": "^2.1.0", - "spdx-license-ids": "^3.0.0" - } - }, - "spdx-license-ids": { - "version": "3.0.23", - "resolved": "https://registry.npmjs.org/spdx-license-ids/-/spdx-license-ids-3.0.23.tgz", - "integrity": "sha512-CWLcCCH7VLu13TgOH+r8p1O/Znwhqv/dbb6lqWy67G+pT1kHmeD/+V36AVb/vq8QMIQwVShJ6Ssl5FPh0fuSdw==", - "dev": true - }, - "spdx-ranges": { - "version": "2.1.1", - "resolved": "https://registry.npmjs.org/spdx-ranges/-/spdx-ranges-2.1.1.tgz", - "integrity": "sha512-mcdpQFV7UDAgLpXEE/jOMqvK4LBoO0uTQg0uvXUewmEFhpiZx5yJSZITHB8w1ZahKdhfZqP5GPEOKLyEq5p8XA==", - "dev": true - }, - "spdx-satisfies": { - "version": "4.0.1", - "resolved": "https://registry.npmjs.org/spdx-satisfies/-/spdx-satisfies-4.0.1.tgz", - "integrity": "sha512-WVzZ/cXAzoNmjCWiEluEA3BjHp5tiUmmhn9MK+X0tBbR9sOqtC6UQwmgCNrAIZvNlMuBUYAaHYfb2oqlF9SwKA==", - "dev": true, - "requires": { - "spdx-compare": "^1.0.0", - "spdx-expression-parse": "^3.0.0", - "spdx-ranges": "^2.0.0" - } - }, - "stickyfill": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/stickyfill/-/stickyfill-1.1.1.tgz", - "integrity": "sha512-GCp7vHAfpao+Qh/3Flh9DXEJ/qSi0KJwJw6zYlZOtRYXWUIpMM6mC2rIep/dK8RQqwW0KxGJIllmjPIBOGN8AA==" - }, - "string_decoder": { - "version": "1.3.0", - "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", - "integrity": "sha512-hkRX8U1WjJFd8LsDJ2yQ/wWWxaopEsABU1XfkM8A+j0+85JAGppt16cr1Whg6KIbb4okU6Mql6BOj+uup/wKeA==", - "requires": { - "safe-buffer": "~5.2.0" - } - }, - "string-width": { - "version": "4.2.3", - "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", - "integrity": "sha512-wKyQRQpjJ0sIp62ErSZdGsjMJWsap5oRNihHhu6G7JVO/9jIB6UyevL+tXuOqrng8j/cxKTWyWUwvSTriiZz/g==", - "requires": { - "emoji-regex": "^8.0.0", - "is-fullwidth-code-point": "^3.0.0", - "strip-ansi": "^6.0.1" - } - }, - "strip-ansi": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-6.0.1.tgz", - "integrity": "sha512-Y38VPSHcqkFrCpFnQ9vuSXmquuv5oXOKpGeT6aGrr3o3Gc9AlVa6JBfUSOCnbxGGZF+/0ooI7KrPuUSztUdU5A==", - "requires": { - "ansi-regex": "^5.0.1" - } - }, - "strnum": { - "version": "2.2.3", - "resolved": "https://registry.npmjs.org/strnum/-/strnum-2.2.3.tgz", - "integrity": "sha512-oKx6RUCuHfT3oyVjtnrmn19H1SiCqgJSg+54XqURKp5aCMbrXrhLjRN9TjuwMjiYstZ0MzDrHqkGZ5dFTKd+zg==" - }, - "styled-components": { - "version": "6.3.9", - "resolved": "https://registry.npmjs.org/styled-components/-/styled-components-6.3.9.tgz", - "integrity": "sha512-J72R4ltw0UBVUlEjTzI0gg2STOqlI9JBhQOL4Dxt7aJOnnSesy0qJDn4PYfMCafk9cWOaVg129Pesl5o+DIh0Q==", - "requires": { - "@emotion/is-prop-valid": "1.4.0", - "@emotion/unitless": "0.10.0", - "@types/stylis": "4.2.7", - "css-to-react-native": "3.2.0", - "csstype": "3.2.3", - "postcss": "8.4.49", - "shallowequal": "1.1.0", - "stylis": "4.3.6", - "tslib": "2.8.1" - } - }, - "stylis": { - "version": "4.3.6", - "resolved": "https://registry.npmjs.org/stylis/-/stylis-4.3.6.tgz", - "integrity": "sha512-yQ3rwFWRfwNUY7H5vpU0wfdkNSnvnJinhF9830Swlaxl03zsOjCfmX0ugac+3LtK0lYSgwL/KXc8oYL3mG4YFQ==" - }, - "supports-color": { - "version": "5.5.0", - "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-5.5.0.tgz", - "integrity": "sha512-QjVjwdXIt408MIiAqCX4oUKsgU2EqAGzs2Ppkm4aQYbjm+ZEWEcW4SfFNTr4uMNZma0ey4f5lgLrkB0aX0QMow==", - "dev": true, - "requires": { - "has-flag": "^3.0.0" - } - }, - "supports-preserve-symlinks-flag": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/supports-preserve-symlinks-flag/-/supports-preserve-symlinks-flag-1.0.0.tgz", - "integrity": "sha512-ot0WnXS9fgdkgIcePe6RHNk1WA8+muPa6cSjeR3V8K27q9BB1rTE3R1p7Hv0z1ZyAc8s6Vvv8DIyWf681MAt0w==", - "dev": true - }, - "swagger2openapi": { - "version": "7.0.8", - "resolved": "https://registry.npmjs.org/swagger2openapi/-/swagger2openapi-7.0.8.tgz", - "integrity": "sha512-upi/0ZGkYgEcLeGieoz8gT74oWHA0E7JivX7aN9mAf+Tc7BQoRBvnIGHoPDw+f9TXTW4s6kGYCZJtauP6OYp7g==", - "requires": { - "call-me-maybe": "^1.0.1", - "node-fetch": "^2.6.1", - "node-fetch-h2": "^2.3.0", - "node-readfiles": "^0.2.0", - "oas-kit-common": "^1.0.8", - "oas-resolver": "^2.5.6", - "oas-schema-walker": "^1.1.5", - "oas-validator": "^5.0.8", - "reftools": "^1.1.9", - "yaml": "^1.10.0", - "yargs": "^17.0.1" - } - }, - "tr46": { - "version": "0.0.3", - "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz", - "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==" - }, - "treeify": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/treeify/-/treeify-1.1.0.tgz", - "integrity": "sha512-1m4RA7xVAJrSGrrXGs0L3YTwyvBs2S8PbRHaLZAkFw7JR8oIFwYtysxlBZhYIa7xSyiYJKZ3iGrrk55cGA3i9A==", - "dev": true - }, - "ts-algebra": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/ts-algebra/-/ts-algebra-1.2.2.tgz", - "integrity": "sha512-kloPhf1hq3JbCPOTYoOWDKxebWjNb2o/LKnNfkWhxVVisFFmMJPPdJeGoGmM+iRLyoXAR61e08Pb+vUXINg8aA==" - }, - "tslib": { - "version": "2.8.1", - "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.8.1.tgz", - "integrity": "sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==" - }, - "uglify-js": { - "version": "3.19.3", - "resolved": "https://registry.npmjs.org/uglify-js/-/uglify-js-3.19.3.tgz", - "integrity": "sha512-v3Xu+yuwBXisp6QYTcH4UbH+xYJXqnq2m/LtQVWKWzYc1iehYnLixoQDN9FH6/j9/oybfd6W9Ghwkl8+UMKTKQ==", - "optional": true - }, - "ulid": { - "version": "3.0.2", - "resolved": "https://registry.npmjs.org/ulid/-/ulid-3.0.2.tgz", - "integrity": "sha512-yu26mwteFYzBAot7KVMqFGCVpsF6g8wXfJzQUHvu1no3+rRRSFcSV2nKeYvNPLD2J4b08jYBDhHUjeH0ygIl9w==" - }, - "undici": { - "version": "6.24.0", - "resolved": "https://registry.npmjs.org/undici/-/undici-6.24.0.tgz", - "integrity": "sha512-lVLNosgqo5EkGqh5XUDhGfsMSoO8K0BAN0TyJLvwNRSl4xWGZlCVYsAIpa/OpA3TvmnM01GWcoKmc3ZWo5wKKA==" - }, - "undici-types": { - "version": "7.18.2", - "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-7.18.2.tgz", - "integrity": "sha512-AsuCzffGHJybSaRrmr5eHr81mwJU3kjw6M+uprWvCXiNeN9SOGwQ3Jn8jb8m3Z6izVgknn1R0FTCEAP2QrLY/w==" - }, - "uri-js-replace": { - "version": "1.0.1", - "resolved": "https://registry.npmjs.org/uri-js-replace/-/uri-js-replace-1.0.1.tgz", - "integrity": "sha512-W+C9NWNLFOoBI2QWDp4UT9pv65r2w5Cx+3sTYFvtMdDBxkKt1syCqsUdSFAChbEe1uK5TfS04wt/nGwmaeIQ0g==" - }, - "url-template": { - "version": "2.0.8", - "resolved": "https://registry.npmjs.org/url-template/-/url-template-2.0.8.tgz", - "integrity": "sha512-XdVKMF4SJ0nP/O7XIPB0JwAEuT9lDIYnNsK8yGVe43y0AWoKeJNdv3ZNWh7ksJ6KqQFjOO6ox/VEitLnaVNufw==" - }, - "use-sync-external-store": { - "version": "1.6.0", - "resolved": "https://registry.npmjs.org/use-sync-external-store/-/use-sync-external-store-1.6.0.tgz", - "integrity": "sha512-Pp6GSwGP/NrPIrxVFAIkOQeyw8lFenOHijQWkUTrDvrF4ALqylP2C/KCkeS9dpUM3KvYRQhna5vt7IL95+ZQ9w==", - "requires": {} - }, - "util-deprecate": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/util-deprecate/-/util-deprecate-1.0.2.tgz", - "integrity": "sha512-EPD5q1uXyFxJpCrLnCc1nHnq3gOa6DZBocAIiI2TaSCA7VCJ1UJDMagCzIkXNsUYfD1daK//LTEQ8xiIbrHtcw==" - }, - "util-extend": { - "version": "1.0.3", - "resolved": "https://registry.npmjs.org/util-extend/-/util-extend-1.0.3.tgz", - "integrity": "sha1-p8IW0mdUUWljeztu3GypEZ4v+T8=", - "dev": true - }, - "validate-npm-package-license": { - "version": "3.0.4", - "resolved": "https://registry.npmjs.org/validate-npm-package-license/-/validate-npm-package-license-3.0.4.tgz", - "integrity": "sha512-DpKm2Ui/xN7/HQKCtpZxoRWBhZ9Z0kqtygG8XCgNQ8ZlDnxuQmWhj566j8fN4Cu3/JmbhsDo7fcAJq4s9h27Ew==", - "dev": true, - "requires": { - "spdx-correct": "^3.0.0", - "spdx-expression-parse": "^3.0.0" - } - }, - "webidl-conversions": { - "version": "3.0.1", - "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz", - "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==" - }, - "whatwg-url": { - "version": "5.0.0", - "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz", - "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==", - "requires": { - "tr46": "~0.0.3", - "webidl-conversions": "^3.0.0" - } - }, - "wordwrap": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/wordwrap/-/wordwrap-1.0.0.tgz", - "integrity": "sha512-gvVzJFlPycKc5dZN4yPkP8w7Dc37BtP1yczEneOb4uq34pXZcvrtRTmWV8W+Ume+XCxKgbjM+nevkyFPMybd4Q==" - }, - "wrap-ansi": { - "version": "7.0.0", - "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", - "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", - "requires": { - "ansi-styles": "^4.0.0", - "string-width": "^4.1.0", - "strip-ansi": "^6.0.0" - }, - "dependencies": { - "ansi-styles": { - "version": "4.3.0", - "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", - "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", - "requires": { - "color-convert": "^2.0.1" - } - }, - "color-convert": { - "version": "2.0.1", - "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", - "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", - "requires": { - "color-name": "~1.1.4" - } - }, - "color-name": { - "version": "1.1.4", - "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", - "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" - } - } - }, - "wrappy": { - "version": "1.0.2", - "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", - "integrity": "sha1-tSQ9jz7BqjXxNkYFvA0QNuMKtp8=", - "dev": true - }, - "ws": { - "version": "7.5.10", - "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.10.tgz", - "integrity": "sha512-+dbF1tHwZpXcbOJdVOkzLDxZP1ailvSxM6ZweXTegylPny803bFhA+vqBYw4s31NSAk4S2Qz+AKXK9a4wkdjcQ==", - "requires": {} - }, - "y18n": { - "version": "5.0.8", - "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", - "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==" - }, - "yaml": { - "version": "1.10.3", - "resolved": "https://registry.npmjs.org/yaml/-/yaml-1.10.3.tgz", - "integrity": "sha512-vIYeF1u3CjlhAFekPPAk2h/Kv4T3mAkMox5OymRiJQB0spDP10LHvt+K7G9Ny6NuuMAb25/6n1qyUjAcGNf/AA==" - }, - "yaml-ast-parser": { - "version": "0.0.43", - "resolved": "https://registry.npmjs.org/yaml-ast-parser/-/yaml-ast-parser-0.0.43.tgz", - "integrity": "sha512-2PTINUwsRqSd+s8XxKaJWQlUuEMHJQyEuh2edBbW8KNJz0SJPwUSD2zRWqezFEdN7IzAgeuYHFUCF7o8zRdZ0A==" - }, - "yargs": { - "version": "17.0.1", - "resolved": "https://registry.npmjs.org/yargs/-/yargs-17.0.1.tgz", - "integrity": "sha512-xBBulfCc8Y6gLFcrPvtqKz9hz8SO0l1Ni8GgDekvBX2ro0HRQImDGnikfc33cgzcYUSncapnNcZDjVFIH3f6KQ==", - "requires": { - "cliui": "^7.0.2", - "escalade": "^3.1.1", - "get-caller-file": "^2.0.5", - "require-directory": "^2.1.1", - "string-width": "^4.2.0", - "y18n": "^5.0.5", - "yargs-parser": "^20.2.2" - } - }, - "yargs-parser": { - "version": "20.2.9", - "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz", - "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==" - } } } diff --git a/poetry.lock b/poetry.lock index e389e8e5e..390609dce 100644 --- a/poetry.lock +++ b/poetry.lock @@ -42,39 +42,39 @@ joserfc = ">=1.6.0" [[package]] name = "black" -version = "26.3.1" +version = "26.5.0" description = "The uncompromising code formatter." optional = false python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "black-26.3.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:86a8b5035fce64f5dcd1b794cf8ec4d31fe458cf6ce3986a30deb434df82a1d2"}, - {file = "black-26.3.1-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:5602bdb96d52d2d0672f24f6ffe5218795736dd34807fd0fd55ccd6bf206168b"}, - {file = "black-26.3.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6c54a4a82e291a1fee5137371ab488866b7c86a3305af4026bdd4dc78642e1ac"}, - {file = "black-26.3.1-cp310-cp310-win_amd64.whl", hash = "sha256:6e131579c243c98f35bce64a7e08e87fb2d610544754675d4a0e73a070a5aa3a"}, - {file = "black-26.3.1-cp310-cp310-win_arm64.whl", hash = "sha256:5ed0ca58586c8d9a487352a96b15272b7fa55d139fc8496b519e78023a8dab0a"}, - {file = "black-26.3.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:28ef38aee69e4b12fda8dba75e21f9b4f979b490c8ac0baa7cb505369ac9e1ff"}, - {file = "black-26.3.1-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:bf9bf162ed91a26f1adba8efda0b573bc6924ec1408a52cc6f82cb73ec2b142c"}, - {file = "black-26.3.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:474c27574d6d7037c1bc875a81d9be0a9a4f9ee95e62800dab3cfaadbf75acd5"}, - {file = "black-26.3.1-cp311-cp311-win_amd64.whl", hash = "sha256:5e9d0d86df21f2e1677cc4bd090cd0e446278bcbbe49bf3659c308c3e402843e"}, - {file = "black-26.3.1-cp311-cp311-win_arm64.whl", hash = "sha256:9a5e9f45e5d5e1c5b5c29b3bd4265dcc90e8b92cf4534520896ed77f791f4da5"}, - {file = "black-26.3.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b5e6f89631eb88a7302d416594a32faeee9fb8fb848290da9d0a5f2903519fc1"}, - {file = "black-26.3.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:41cd2012d35b47d589cb8a16faf8a32ef7a336f56356babd9fcf70939ad1897f"}, - {file = "black-26.3.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:0f76ff19ec5297dd8e66eb64deda23631e642c9393ab592826fd4bdc97a4bce7"}, - {file = "black-26.3.1-cp312-cp312-win_amd64.whl", hash = "sha256:ddb113db38838eb9f043623ba274cfaf7d51d5b0c22ecb30afe58b1bb8322983"}, - {file = "black-26.3.1-cp312-cp312-win_arm64.whl", hash = "sha256:dfdd51fc3e64ea4f35873d1b3fb25326773d55d2329ff8449139ebaad7357efb"}, - {file = "black-26.3.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:855822d90f884905362f602880ed8b5df1b7e3ee7d0db2502d4388a954cc8c54"}, - {file = "black-26.3.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:8a33d657f3276328ce00e4d37fe70361e1ec7614da5d7b6e78de5426cb56332f"}, - {file = "black-26.3.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f1cd08e99d2f9317292a311dfe578fd2a24b15dbce97792f9c4d752275c1fa56"}, - {file = "black-26.3.1-cp313-cp313-win_amd64.whl", hash = "sha256:c7e72339f841b5a237ff14f7d3880ddd0fc7f98a1199e8c4327f9a4f478c1839"}, - {file = "black-26.3.1-cp313-cp313-win_arm64.whl", hash = "sha256:afc622538b430aa4c8c853f7f63bc582b3b8030fd8c80b70fb5fa5b834e575c2"}, - {file = "black-26.3.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:2d6bfaf7fd0993b420bed691f20f9492d53ce9a2bcccea4b797d34e947318a78"}, - {file = "black-26.3.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:f89f2ab047c76a9c03f78d0d66ca519e389519902fa27e7a91117ef7611c0568"}, - {file = "black-26.3.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:b07fc0dab849d24a80a29cfab8d8a19187d1c4685d8a5e6385a5ce323c1f015f"}, - {file = "black-26.3.1-cp314-cp314-win_amd64.whl", hash = "sha256:0126ae5b7c09957da2bdbd91a9ba1207453feada9e9fe51992848658c6c8e01c"}, - {file = "black-26.3.1-cp314-cp314-win_arm64.whl", hash = "sha256:92c0ec1f2cc149551a2b7b47efc32c866406b6891b0ee4625e95967c8f4acfb1"}, - {file = "black-26.3.1-py3-none-any.whl", hash = "sha256:2bd5aa94fc267d38bb21a70d7410a89f1a1d318841855f698746f8e7f51acd1b"}, - {file = "black-26.3.1.tar.gz", hash = "sha256:2c50f5063a9641c7eed7795014ba37b0f5fa227f3d408b968936e24bc0566b07"}, + {file = "black-26.5.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:402454bfdd7a940be00455e87309438a24b328b7ba7d80b7207e8a87b32ffc29"}, + {file = "black-26.5.0-cp310-cp310-macosx_11_0_arm64.whl", hash = "sha256:4863b2a2c382661a018bf2213f2b957fa34511df131259ffaa8d54859620ac31"}, + {file = "black-26.5.0-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:490b623006a75c0ea59c1ecf91cc76ecb9d66df1482c3a53f4f7de95a7c85e10"}, + {file = "black-26.5.0-cp310-cp310-win_amd64.whl", hash = "sha256:6f53deb3d1108a523212da5c79e5c0cd76abcc548948f2d8415e62929c81a569"}, + {file = "black-26.5.0-cp310-cp310-win_arm64.whl", hash = "sha256:a62f9d069ac27de20c6fa3dbf60d7c951141c4025bb9755274802d05b1aa418b"}, + {file = "black-26.5.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:862945b2a08193cdff9f632f51bdadbb11e6852da1d31c306a3508449dc81b84"}, + {file = "black-26.5.0-cp311-cp311-macosx_11_0_arm64.whl", hash = "sha256:03102aa97c279e5f62e1e1ab828cfe8aa72c3af4cf86f9448e5537b2519cbfea"}, + {file = "black-26.5.0-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:990ee0e1d96dd8ca623f19dd3f339c138bdc02f74e4fea01cc64aee38944ea2b"}, + {file = "black-26.5.0-cp311-cp311-win_amd64.whl", hash = "sha256:209fabb250681900502b3b6a03e31d8cac606c9ef9629fd0fbd5d33235647c00"}, + {file = "black-26.5.0-cp311-cp311-win_arm64.whl", hash = "sha256:dbb6fc70f8bd9821981fd47efb68a5be0eee9055f400eb3bf2dbebf49f9ec4fe"}, + {file = "black-26.5.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:b92983a6674c133ca61d6b4fea17f76cbbaac582ea583002792ee1094dbece49"}, + {file = "black-26.5.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:1f80998e73fcfc67fc1d222060cf34ab213f1ae7e131b5c8199d93405890c13a"}, + {file = "black-26.5.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:081df4dc908702e2becd66d714f125a954cbf1c6dbe2ad83a6be313368c7c2db"}, + {file = "black-26.5.0-cp312-cp312-win_amd64.whl", hash = "sha256:cf015b38829ca32a699312fdcfb8c15bd0b156192f5400bd0b559c6bfef25236"}, + {file = "black-26.5.0-cp312-cp312-win_arm64.whl", hash = "sha256:828db2292848cf427592fcd162f02d770849d20ea4bdda2806e9494b3a15d481"}, + {file = "black-26.5.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:c2b64ce9841e8b8254c3d702ebccdaf5c520607df8aa4176f5732b7f9af1e6f6"}, + {file = "black-26.5.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:0a789a41b386f0f83711785f182f2977138ba9cc1f41ad0f6fbc8faac4d2639e"}, + {file = "black-26.5.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f69837f7e26d67b1d1e9d0ed49231a14a0469f266e44cd142873e0552f325395"}, + {file = "black-26.5.0-cp313-cp313-win_amd64.whl", hash = "sha256:c5b08371561dae9c90391fe7f2138fe7fa495437d3bb134eb865839036e65784"}, + {file = "black-26.5.0-cp313-cp313-win_arm64.whl", hash = "sha256:3968ce82ca0bd4914769518490d91a9b0ef2ff2fc68e2122d22b5915a0342eaa"}, + {file = "black-26.5.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:ea8a0c4505486c132c6640e4e108d25f41360a06d844db5a76477c3dbae1b616"}, + {file = "black-26.5.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:2178a70e7c45fb85999b687d8326abceef1e7227463d5d7e07ef125c9fbb9c5c"}, + {file = "black-26.5.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f3ad14d7c24c40eafecf4fb212d9c01e7c7b2ab05c8646b351c93728f499c555"}, + {file = "black-26.5.0-cp314-cp314-win_amd64.whl", hash = "sha256:8ea767bae9c4f331ea9ad2e08895c951e600dffd550a42624d5210a908720b39"}, + {file = "black-26.5.0-cp314-cp314-win_arm64.whl", hash = "sha256:d658f4ee6167797b08be07ee4bbf6045753ddabfc676c3cb0eec23752ca83eff"}, + {file = "black-26.5.0-py3-none-any.whl", hash = "sha256:241f25bf59f5ca17f5121031e310e089b84cd22bb4eca47360099ea825544f17"}, + {file = "black-26.5.0.tar.gz", hash = "sha256:5cbe4cc4037ffca34cdb0a6a9a046f104b262d0bd63c30fd4a88c7adc2049b1d"}, ] [package.dependencies] @@ -1761,14 +1761,14 @@ rpds-py = ">=0.7.0" [[package]] name = "requests" -version = "2.34.0" +version = "2.34.2" description = "Python HTTP for Humans." optional = false python-versions = ">=3.10" groups = ["main", "dev"] files = [ - {file = "requests-2.34.0-py3-none-any.whl", hash = "sha256:917520a21b767485ce7c588f4ebb917c436b24a31231b44228715eaeb5a52c60"}, - {file = "requests-2.34.0.tar.gz", hash = "sha256:7d62fe92f50eb82c529b0916bb445afa1531a566fc8f35ffdc64446e771b856a"}, + {file = "requests-2.34.2-py3-none-any.whl", hash = "sha256:2a0d60c172f83ac6ab31e4554906c0f3b3588d37b5cb939b1c061f4907e278e0"}, + {file = "requests-2.34.2.tar.gz", hash = "sha256:f288924cae4e29463698d6d60bc6a4da69c89185ad1e0bcc4104f584e960b9ed"}, ] [package.dependencies] diff --git a/sandbox/package-lock.json b/sandbox/package-lock.json index c230c76a0..67d8ea851 100644 --- a/sandbox/package-lock.json +++ b/sandbox/package-lock.json @@ -261,9 +261,9 @@ } }, "node_modules/@hapi/content": { - "version": "6.0.1", - "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.1.tgz", - "integrity": "sha512-lQ2vOoFMNYxwKVnKf+3Pi3PfoviM4EJYlT9JbrBPfEc0xKMiVDqqXF8UTE1S1oKhHQliWSP5t6zTKNlmaXBGcQ==", + "version": "6.0.2", + "resolved": "https://registry.npmjs.org/@hapi/content/-/content-6.0.2.tgz", + "integrity": "sha512-OKyCOTjNR1hftwSjk9ueyAQTw8AwapvzBrPIWMGn39vhR5PmqLdYFmLc35bsSBye7gSMnlkXfc679bUdMIcRyQ==", "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.0" @@ -288,9 +288,9 @@ "license": "BSD-3-Clause" }, "node_modules/@hapi/hapi": { - "version": "21.4.7", - "resolved": "https://registry.npmjs.org/@hapi/hapi/-/hapi-21.4.7.tgz", - "integrity": "sha512-BNO7EgGdDPUaNGhkEiaW8xqk7IqzZNDljBPLcAZgyzpAKl72YR5sBlzfQG1ncrS7O1A7NPLHJkJJgd4YYHDHfg==", + "version": "21.4.9", + "resolved": "https://registry.npmjs.org/@hapi/hapi/-/hapi-21.4.9.tgz", + "integrity": "sha512-YnecZOVx2AD08VvPl0ZaFS0MjEHqg+InGRmBRli731ct+VwI++dpu3BIYA1Z4SMr6HUAnpyvbQ1aq5woe3fBWg==", "license": "BSD-3-Clause", "dependencies": { "@hapi/accept": "^6.0.3", @@ -307,7 +307,7 @@ "@hapi/shot": "^6.0.2", "@hapi/somever": "^4.1.1", "@hapi/statehood": "^8.2.1", - "@hapi/subtext": "^8.1.1", + "@hapi/subtext": "^8.1.3", "@hapi/teamwork": "^6.0.1", "@hapi/topo": "^6.0.2", "@hapi/validate": "^2.0.1" @@ -384,15 +384,15 @@ } }, "node_modules/@hapi/pez": { - "version": "6.1.0", - "resolved": "https://registry.npmjs.org/@hapi/pez/-/pez-6.1.0.tgz", - "integrity": "sha512-+FE3sFPYuXCpuVeHQ/Qag1b45clR2o54QoonE/gKHv9gukxQ8oJJZPR7o3/ydDTK6racnCJXxOyT1T93FCJMIg==", + "version": "6.1.1", + "resolved": "https://registry.npmjs.org/@hapi/pez/-/pez-6.1.1.tgz", + "integrity": "sha512-yg2OS1tC0S1sHXvhUtWsfRn6lrKl9jKtRhZ+EI0woOW/gqX5vM2PZ1459ypCvCYDRLJ9nIyueeEH5MJV1ZDqIg==", "license": "BSD-3-Clause", "dependencies": { "@hapi/b64": "^6.0.1", "@hapi/boom": "^10.0.1", - "@hapi/content": "^6.0.0", - "@hapi/hoek": "^11.0.2", + "@hapi/content": "^6.0.1", + "@hapi/hoek": "^11.0.7", "@hapi/nigel": "^5.0.1" } }, @@ -443,18 +443,18 @@ } }, "node_modules/@hapi/subtext": { - "version": "8.1.1", - "resolved": "https://registry.npmjs.org/@hapi/subtext/-/subtext-8.1.1.tgz", - "integrity": "sha512-ex1Y2s/KuJktS8Ww0k6XJ5ysSKrzNym4i5pDVuCwlSgHHviHUsT1JNzE6FYhNU9TTHSNdyfue/t2m89bpkX9Jw==", + "version": "8.1.3", + "resolved": "https://registry.npmjs.org/@hapi/subtext/-/subtext-8.1.3.tgz", + "integrity": "sha512-WTpEZQjBP3UJ3gGunNl3w5Ao1EOJsuu2vttZ2KEcG+csSLxc0dI6VIkl2md2jDlHiQ2ARAoqdSUScy05A/NHtA==", "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", "@hapi/bourne": "^3.0.0", - "@hapi/content": "^6.0.0", + "@hapi/content": "^6.0.2", "@hapi/file": "^3.0.0", - "@hapi/hoek": "^11.0.2", - "@hapi/pez": "^6.1.0", - "@hapi/wreck": "^18.0.1" + "@hapi/hoek": "^11.0.7", + "@hapi/pez": "^6.1.1", + "@hapi/wreck": "^18.1.1" } }, "node_modules/@hapi/teamwork": { @@ -495,9 +495,9 @@ } }, "node_modules/@hapi/wreck": { - "version": "18.1.0", - "resolved": "https://registry.npmjs.org/@hapi/wreck/-/wreck-18.1.0.tgz", - "integrity": "sha512-0z6ZRCmFEfV/MQqkQomJ7sl/hyxvcZM7LtuVqN3vdAO4vM9eBbowl0kaqQj9EJJQab+3Uuh1GxbGIBFy4NfJ4w==", + "version": "18.1.1", + "resolved": "https://registry.npmjs.org/@hapi/wreck/-/wreck-18.1.1.tgz", + "integrity": "sha512-UwTeGBfAnB/1mkw4gD6IQGI/bgMu7iGmqgT8K+xxye3z4ZHhCZlmS2wuHBJmENhBJSKqvoYzJ71ds3Xfq4gofQ==", "license": "BSD-3-Clause", "dependencies": { "@hapi/boom": "^10.0.1", @@ -506,29 +506,43 @@ } }, "node_modules/@humanfs/core": { - "version": "0.19.1", - "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.1.tgz", - "integrity": "sha512-5DyQ4+1JEUzejeK1JGICcideyfUbGixgS9jNgex5nqkW+cY7WZhxBigmieN5Qnw9ZosSNVC9KQKyb+GUaGyKUA==", + "version": "0.19.2", + "resolved": "https://registry.npmjs.org/@humanfs/core/-/core-0.19.2.tgz", + "integrity": "sha512-UhXNm+CFMWcbChXywFwkmhqjs3PRCmcSa/hfBgLIb7oQ5HNb1wS0icWsGtSAUNgefHeI+eBrA8I1fxmbHsGdvA==", "dev": true, "license": "Apache-2.0", + "dependencies": { + "@humanfs/types": "^0.15.0" + }, "engines": { "node": ">=18.18.0" } }, "node_modules/@humanfs/node": { - "version": "0.16.7", - "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.7.tgz", - "integrity": "sha512-/zUx+yOsIrG4Y43Eh2peDeKCxlRt/gET6aHfaKpuq267qXdYDFViVHfMaLyygZOnl0kGWxFIgsBy8QFuTLUXEQ==", + "version": "0.16.8", + "resolved": "https://registry.npmjs.org/@humanfs/node/-/node-0.16.8.tgz", + "integrity": "sha512-gE1eQNZ3R++kTzFUpdGlpmy8kDZD/MLyHqDwqjkVQI0JMdI1D51sy1H958PNXYkM2rAac7e5/CnIKZrHtPh3BQ==", "dev": true, "license": "Apache-2.0", "dependencies": { - "@humanfs/core": "^0.19.1", + "@humanfs/core": "^0.19.2", + "@humanfs/types": "^0.15.0", "@humanwhocodes/retry": "^0.4.0" }, "engines": { "node": ">=18.18.0" } }, + "node_modules/@humanfs/types": { + "version": "0.15.0", + "resolved": "https://registry.npmjs.org/@humanfs/types/-/types-0.15.0.tgz", + "integrity": "sha512-ZZ1w0aoQkwuUuC7Yf+7sdeaNfqQiiLcSRbfI08oAxqLtpXQr9AIVX7Ay7HLDuiLYAaFPu8oBYNq/QIi9URHJ3Q==", + "dev": true, + "license": "Apache-2.0", + "engines": { + "node": ">=18.18.0" + } + }, "node_modules/@humanwhocodes/module-importer": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/@humanwhocodes/module-importer/-/module-importer-1.0.1.tgz", @@ -558,9 +572,9 @@ } }, "node_modules/@types/estree": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.8.tgz", - "integrity": "sha512-dWHzHa2WqEXI/O1E9OjrocMTKJl2mSrEolh1Iomrv6U+JuNwaHXsXx9bLu5gG7BUWFIN0skIQJQ/L1rIex4X6w==", + "version": "1.0.9", + "resolved": "https://registry.npmjs.org/@types/estree/-/estree-1.0.9.tgz", + "integrity": "sha512-GhdPgy1el4/ImP05X05Uw4cw2/M93BCUmnEvWZNStlCzEKME4Fkk+YpoA5OiHNQmoS7Cafb8Xa3Pya8m1Qrzeg==", "dev": true, "license": "MIT" }, @@ -595,9 +609,9 @@ } }, "node_modules/ajv": { - "version": "6.14.0", - "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.14.0.tgz", - "integrity": "sha512-IWrosm/yrn43eiKqkfkHis7QioDleaXQHdDVPKg0FSwwd/DuvyX79TZnFOnYpB7dcsFAMmtFztZuXPDvSePkFw==", + "version": "6.15.0", + "resolved": "https://registry.npmjs.org/ajv/-/ajv-6.15.0.tgz", + "integrity": "sha512-fgFx7Hfoq60ytK2c7DhnF8jIvzYgOMxfugjLOSMHjLIPgenqa7S7oaagATUq99mV6IYvN2tRmC0wnTYX6iPbMw==", "dev": true, "license": "MIT", "dependencies": { @@ -642,9 +656,9 @@ "license": "MIT" }, "node_modules/brace-expansion": { - "version": "1.1.13", - "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.13.tgz", - "integrity": "sha512-9ZLprWS6EENmhEOpjCYW2c8VkmOvckIJZfkr7rBW6dObmfgJ/L1GpSYW5Hpo9lDz4D1+n0Ckz8rU7FwHDQiG/w==", + "version": "1.1.14", + "resolved": "https://registry.npmjs.org/brace-expansion/-/brace-expansion-1.1.14.tgz", + "integrity": "sha512-MWPGfDxnyzKU7rNOW9SP/c50vi3xrmrua/+6hfPbCS2ABNWfx24vPidzvC7krjU/RTo235sV776ymlsMtGKj8g==", "dev": true, "license": "MIT", "dependencies": { @@ -999,9 +1013,9 @@ } }, "node_modules/globals": { - "version": "17.4.0", - "resolved": "https://registry.npmjs.org/globals/-/globals-17.4.0.tgz", - "integrity": "sha512-hjrNztw/VajQwOLsMNT1cbJiH2muO3OROCHnbehc8eY5JyD2gqz4AcMHPqgaOR59DjgUjYAYLeH699g/eWi2jw==", + "version": "17.6.0", + "resolved": "https://registry.npmjs.org/globals/-/globals-17.6.0.tgz", + "integrity": "sha512-sepffkT8stwnIYbsMBpoCHJuJM5l98FUF2AnE07hfvE0m/qp3R586hw4jF4uadbhvg1ooIdzuu7CsfD2jzCaNA==", "dev": true, "license": "MIT", "engines": { @@ -1163,9 +1177,9 @@ } }, "node_modules/lodash": { - "version": "4.17.23", - "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.23.tgz", - "integrity": "sha512-LgVTMpQtIopCi79SJeDiP0TfWi5CNEc/L/aRdTh3yIvmZXTnheWpKjSZhnvMl8iXbC1tFg9gdHHDMLoV7CnG+w==", + "version": "4.18.1", + "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.18.1.tgz", + "integrity": "sha512-dMInicTPVE8d1e5otfwmmjlxkZoUpiVLwyeTdUsi/Caj/gfzzblBcCE5sRHV/AsjuCmxWrte2TNGSYuCeCq+0Q==", "license": "MIT" }, "node_modules/lodash.merge": { From edf6f4b432df30467957543fb430120bcb0cf599 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 27 May 2026 10:06:01 +0000 Subject: [PATCH 48/55] Add Copilot context files for onboarding and developer handover - Split copilot-instructions.md into targeted .instructions.md files (proxy, sandbox, testing, specification) loaded by applyTo patterns - Add /overview, /release, and /add-context prompts - Document release process, sandbox patterns, Actor model, and proxy architecture --- .github/copilot-instructions.md | 106 +++++++++ .github/instructions/proxy.instructions.md | 140 +++++++++++ .github/instructions/sandbox.instructions.md | 123 ++++++++++ .../specification.instructions.md | 84 +++++++ .github/instructions/testing.instructions.md | 126 ++++++++++ .github/prompts/add-context.prompt.md | 27 +++ .github/prompts/overview.prompt.md | 94 ++++++++ .github/prompts/release.prompt.md | 85 +++++++ .../stu3/services/mockResponseProvider.js | 4 +- tests/conftest.py | 20 +- tests/integration/test_user_restricted.py | 219 +----------------- 11 files changed, 794 insertions(+), 234 deletions(-) create mode 100644 .github/copilot-instructions.md create mode 100644 .github/instructions/proxy.instructions.md create mode 100644 .github/instructions/sandbox.instructions.md create mode 100644 .github/instructions/specification.instructions.md create mode 100644 .github/instructions/testing.instructions.md create mode 100644 .github/prompts/add-context.prompt.md create mode 100644 .github/prompts/overview.prompt.md create mode 100644 .github/prompts/release.prompt.md diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 000000000..4ce6af91d --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,106 @@ +# e-Referrals Service API — Copilot Context + +## What is this repo? + +This is the **e-Referral Service (e-RS) FHIR API** maintained by NHS Digital. It provides RESTful endpoints for creating paperless referrals from primary to secondary care. The repo contains the OpenAPI specification, an Apigee API proxy layer, a Node.js sandbox (mock server), and Python-based test suites. + +This repo is the **API layer** — it does NOT contain the e-RS core application. The Apigee proxy forwards authenticated requests to the real e-RS backend at `/ers-api`. The sandbox returns fixture data for development and never touches the real backend. + +The live API documentation is published to the [NHS Developer Hub](https://digital.nhs.uk/developer/api-catalogue/e-referral-service-fhir). + +## Sibling repository + +This repo has a sibling: **`e-referrals-service-patient-care-api`**. Both repos follow the same structure and procedures (environment setup, `make publish`, release process). If you know how to work in one, you can work in the other. + +## Repository structure + +| Directory | Purpose | +|---|---| +| `specification/` | OpenAPI 3.0 spec with components split across `components/r4/` (FHIR R4) and `components/stu3/` (FHIR STU3) | +| `sandbox/` | Node.js (Hapi) mock server. Entry: `sandbox/src/app.js`. Routes: `sandbox/src/routes/{stu3,r4}/`. Fixtures: `sandbox/src/mocks/` | +| `proxies/live/` | Production Apigee proxy (~60 policies: OAuth, ASID, ODS allowlist, rate limiting, header swapping) | +| `proxies/sandbox/` | Lightweight Apigee proxy (~11 policies, no auth) forwarding to the mock server | +| `tests/` | Python pytest suites: `sandbox/`, `integration/`, `smoke/` | +| `terraform/` | Apigee infrastructure-as-code using `api-platform-service-module` | +| `scripts/` | Build & dev utilities | +| `azure/` | Azure DevOps CI/CD pipeline definitions | +| `build/` | Generated output — bundled single-file OAS JSON | + +## FHIR versions + +- **STU3** — the original version, most endpoints live here +- **R4** — newer endpoints (business functions, healthcare services, service requests, attachments) + +Routes, schemas, examples, and tests all mirror this split. + +## Package management + +| Ecosystem | Tool | Config file | Install | +|---|---|---|---| +| Python | **Poetry** (package-mode=false) | `pyproject.toml` / `poetry.lock` | `poetry install` | +| Node (root) | **npm** | `package.json` | `npm install` | +| Node (sandbox) | **npm** | `sandbox/package.json` | `cd sandbox && npm install` | + +- Python ≥ 3.13 required +- Root `package.json` is only `@redocly/cli` for OAS linting/bundling +- `make install` installs all three plus git hooks + +## Key make targets + +``` +make clean-environment # Delete the pyenv 'apigee' virtual environment +make setup-environment # Bootstrap dev environment (pyenv, Python 3.13, dependencies) — run in a NEW terminal after +make install # Install all deps (node + poetry + git hooks) +make lint # Lint OAS spec, sandbox JS, XML proxies, Python +make publish # Bundle OAS spec → build/e-referrals-service-api.json +make serve # Preview spec docs on port 5000 +make sandbox # Build & run sandbox Docker container (port 9100→9000) +make sandbox-tests # Run sandbox pytest suite +make release # Full release build +``` + +## Environment setup (first time / reset) + +1. `make clean-environment` — removes the pyenv `apigee` virtual environment (skip on first setup) +2. Open a **new terminal** (so shell profile changes take effect) +3. `make setup-environment` — installs pyenv, Python 3.13, creates the `apigee` venv, installs Poetry +4. Open a **new terminal** again +5. `pyenv version` — should show `apigee`. If not, repeat steps 1–4 +6. `make install` — installs Node deps (root + sandbox) and Poetry deps + git hooks + +The `.python-version` file auto-activates the `apigee` venv when you `cd` into the repo. + +## Release process + +1. `make publish` — bundles the OAS spec into a single JSON file: + - Redocly CLI reads `specification/e-referrals-service-api.yaml`, resolves all `$ref`s, dereferences, and removes unused components + - Piped through `scripts/set_version.py` — calculates the version from git commit messages (using `+major`, `+minor`, `+setstatus` commands in commit messages) and injects it into `info.version` + - Piped through `scripts/populate_placeholders.py` — replaces `[[HYPERLINK_*]]` placeholders with actual markdown links for the Developer Hub + - Output: `build/e-referrals-service-api.json` — this is the OAS file that goes into Apigee +2. `make release` — runs `clean` → `publish` → `build_proxy` → packages everything into `dist/` +3. Deployment is handled by the release management process (not individual developers) — the Azure DevOps release pipeline is triggered by a `v*` tag push, which deploys to Apigee environments + +## CI/CD + +- **Azure DevOps** pipelines in `azure/` — build, PR validation, release +- Extends shared templates from `NHSDigital/api-management-utils` +- Release pipeline packages spec + proxies + tests into `dist/` +- GitHub has `dependabot.yml` for dependency updates and PR/issue templates + +## Branching + +- **develop** — default working branch; create PRs from here +- **master** — release branch; merges to master are part of the release process + +## Licensing + +Dual licensed MIT + OGL (Open Government License). **No GPL or AGPL dependencies allowed** — this would violate the terms of those libraries' licenses. Check before adding any new package. + +## Deeper context + +Detailed context for specific areas is split into separate instruction files that load automatically when you're working in the relevant part of the codebase: + +- `proxies/**` → proxy architecture, request flow, policies, shared flows +- `sandbox/**` → sandbox architecture, route handler patterns, mock response provider +- `tests/**` → test structure, Actor model, activity codes, SandboxTest base class +- `specification/**` → OAS workflow, examples pipeline, Redocly config diff --git a/.github/instructions/proxy.instructions.md b/.github/instructions/proxy.instructions.md new file mode 100644 index 000000000..c9036a2ff --- /dev/null +++ b/.github/instructions/proxy.instructions.md @@ -0,0 +1,140 @@ +--- +applyTo: "proxies/**" +description: "Apigee proxy architecture, request flow, policies, shared flows, and how to modify proxy configuration" +--- + +# Apigee Proxy Architecture + +The `proxies/` directory contains two independent Apigee API proxy bundles that share the same base path (`{{ SERVICE_BASE_PATH }}` → `/referrals`). + +## `proxies/live/` — production proxy + +Forwards requests to the real e-RS backend. This is the most policy-heavy part of the repo. + +### Layout + +| Path | Purpose | +|---|---| +| `apiproxy/ers.xml` | Root proxy descriptor | +| `apiproxy/proxies/default.xml` | ProxyEndpoint — inbound routing (`_ping`, `_status`, catch-all to target) | +| `apiproxy/targets/ers-target.xml` | TargetEndpoint — outbound to backend via `{{ ERS_TARGET_SERVER }}`, plus all auth/error handling | +| `apiproxy/policies/` | ~60 XML policy files (see breakdown below) | +| `apiproxy/resources/jsc/` | Inline JavaScript used by policies (`IsFhirR4Path.js`, `SetCurrentTimestamp.js`, `SetStatusResponse.js`) | + +### Request flow (PreFlow on TargetEndpoint) + +1. `javascript.IsFhirR4Path` — sets `isFhirR4Path` boolean by matching `/FHIR/R4/` in the path suffix; this flag drives R4-vs-STU3 branching throughout +2. `OauthV2.VerifyAccessToken` — validates OAuth2 token; accepted scopes: `app:level3`, `user-nhs-id:aal3`, `user-nhs-id:aal2` +3. `FlowCallout.ExtendedAttributes` + `FlowCallout.EUOAllowlistVerify` — (user-restricted only, excluding `/FHIR/R4/PractitionerRole`) validates the end-user organisation ODS code against an allowlist +4. ASID validation — `RaiseFault.MissingAsid` if `app.asid` is empty; then `AssignMessage.PopulateAsidFromApp` + `AssignMessage.SetAsidHeader` copy the ASID onto the request +5. `AssignMessage.AddBaseUrlHeader` — adds the base URL header for the backend +6. `FlowCallout.ApplyRateLimiting` — spike arrest + quota enforcement (delegates to external shared flow — rate/quota values are NOT in this repo) + +### Shared flows (external dependencies) + +Several `FlowCallout.*` policies delegate to shared flows that are NOT defined in this repo: +- `ApplyRateLimiting` — spike arrest and quota enforcement (rate/quota values configured externally) +- `ExtendedAttributes` — retrieves extended app attributes +- `EUOAllowlistVerify` — validates ODS code against the end-user organisation allowlist +- `LogToSplunk` — audit logging + +These shared flows are deployed separately to the Apigee environment. This repo only controls *when* they are called and *how* their errors are handled. + +### Conditional flows (TargetEndpoint) + +- **`user-restricted-flow`** (`accesstoken.auth_type == "user"`) — rejects app-only business functions (`AUTHORISED_APPLICATION`), swaps NHSD headers from external to internal naming, sets AAL/IAL/AMR headers, and enforces IAL ≥ 3 +- **`app-restricted-flow`** (`accesstoken.auth_type == "app"`) — rejects any manually-set `x-ers-*` headers (403), then sets fixed app-restricted values for ODS, business function, user-id, and access-mode +- **`undefined-flow`** — catch-all that returns 403 (should never trigger) + +Both flows finish with `AssignMessage.Swap.CorrelationHeader` which converts `X-Correlation-ID` → `NHSD-Correlation-ID` for the backend. + +### Header transformation mapping + +The proxy swaps external consumer-facing headers to internal backend headers: + +| External header (consumer sends) | Internal header (backend receives) | +|---|---| +| `X-Correlation-ID` | `NHSD-Correlation-ID` (appended with `.{messageid}`) | +| `nhsd-end-user-organisation-ods` | `x-ers-ods-code` | +| `nhsd-ers-business-function` | `x-ers-business-function` | +| `nhsd-ers-comm-rule-org` | `x-ers-comm-rule-org` | +| `nhsd-ers-file-name` | `x-ers-file-name` | +| `nhsd-ers-referral-id` | `x-ers-referral-id` | +| `NHSD-eRS-On-Behalf-Of-User-ID` | `x-ers-on-behalf-of-user-id` | + +Additional headers set by the proxy (not from consumer input): +- `x-ers-access-mode` — `user` or `app` +- `x-ers-user-id` — from OAuth token (user) or app config (app) +- `x-ers-authentication-assurance-level` — from token +- `x-ers-id-assurance-level` — from token +- `x-ers-amr` — authentication method reference from token + +### Response flow + +- Sets `X-Request-ID` flag, swaps `x_ers_transaction_id` to the response, removes `nhsd-correlation-id` from the response + +### FaultRules (TargetEndpoint) + +Error responses are FHIR-version-aware — `isFhirR4Path` selects between R4 and pre-R4 `OperationOutcome` response shapes. Handled faults: +- OAuth token failures (scope errors → AAL insufficient) +- Spike arrest / quota exceeded (rate limiting) +- Insufficient IAL (identity assurance level < 3) +- Missing ASID +- Invalid business function +- ODS header missing / not in partner allowlist +- EUO allowlist internal errors (500) + +### Backend connection + +- Target server: `{{ ERS_TARGET_SERVER }}` (defaults to `e-referrals-service-api`) +- Backend path: `/ers-api` +- TLS enabled; conditional truststore for feature-test (`--ft-`) environments +- I/O timeout: 180 seconds +- Jinja2 templating (`{{ }}` placeholders) is resolved at build time by `scripts/build_proxy.sh` + +### Policy naming conventions + +- `AssignMessage.Set.*` — set a header/variable to a fixed value +- `AssignMessage.Swap.*` — rename/transform a header between external and internal naming +- `AssignMessage.Remove.*` — strip a header +- `AssignMessage.SetOperationOutcome*` — prepare FHIR OperationOutcome error variables +- `RaiseFault.*` — return an HTTP error status +- `FlowCallout.*` — delegate to a shared flow +- `KeyValueMapOperations.*` — read from Apigee KVM stores + +## `proxies/sandbox/` — sandbox proxy + +Lightweight proxy that forwards to the sandbox container (Hapi.js mock server) via Apigee hosted targets. + +### Key differences from live + +- Only ~11 policies (vs ~60 in live) — no OAuth, no ASID, no rate limiting, no header swapping +- Adds CORS preflight handling (`AssignMessage.AddCors` on OPTIONS) +- Uses `DecodeJWT.FromJWTHeader` to decode (but not validate) the JWT for inspection +- Target is `{{ HOSTED_TARGET_CONNECTION }}` — the sandbox container deployed alongside the proxy +- No fault rules or auth enforcement + +### Shared structure + +Both proxies share `_ping` and `_status` flows — `_ping` returns a canned response directly (no backend call), `_status` uses an API key from KVM + `ServiceCallout.CallHealthcheckEndpoint`. + +## Proxy build process + +`scripts/build_proxy.sh` copies both proxy bundles into `build/proxies/`, and for sandbox, rsyncs the entire `sandbox/` app into `build/proxies/sandbox/apiproxy/resources/hosted/` so Apigee can run it as a hosted target. + +Jinja2 template variables (e.g. `{{ SERVICE_BASE_PATH }}`, `{{ ERS_TARGET_SERVER }}`, `{{ HOSTED_TARGET_CONNECTION }}`) are resolved during the CI/CD pipeline deployment step. + +## Infrastructure + +- **Apigee** API gateway managed via Terraform (`terraform/main.tf`) +- Uses the `api-platform-service-module` from NHSDigital +- Backend: Azure (`azurerm` state backend) +- Proxy type auto-selects `sandbox` or `live` based on Apigee environment name + +## Adding or modifying a proxy policy + +1. Create/edit the XML file in `proxies/live/apiproxy/policies/` (or `sandbox/`) +2. Reference it by `` in the appropriate flow in `proxies/default.xml` or `ers-target.xml` +3. If it uses JavaScript, add the `.js` file to `apiproxy/resources/jsc/` and reference via `jsc://filename.js` +4. Run `make lint` — validates all proxy XML via `scripts/xml_validator.py` +5. Remember to handle both R4 and pre-R4 paths if the policy produces FHIR error responses diff --git a/.github/instructions/sandbox.instructions.md b/.github/instructions/sandbox.instructions.md new file mode 100644 index 000000000..d3cb399f5 --- /dev/null +++ b/.github/instructions/sandbox.instructions.md @@ -0,0 +1,123 @@ +--- +applyTo: "sandbox/**" +description: "Sandbox mock server architecture, route handler patterns, mock response provider, and how to add new endpoints" +--- + +# Sandbox Architecture + +The sandbox is a **Hapi.js (v21)** mock server that simulates the e-RS FHIR API. It returns static fixture data and never connects to the real backend. + +## Structure + +| Path | Purpose | +|---|---| +| `sandbox/src/app.js` | Server entry point — port 9000, CORS config, common response headers | +| `sandbox/src/routes/index.js` | Aggregates all route handlers from `stu3/` and `r4/` subdirectories | +| `sandbox/src/routes/stu3/` | STU3 FHIR endpoint handlers (one file per endpoint) | +| `sandbox/src/routes/r4/` | R4 FHIR endpoint handlers | +| `sandbox/src/routes/common/validationUtils.js` | Shared validation utilities (business function checks, UUID validation) | +| `sandbox/src/routes/stu3/services/mockResponseProvider.js` | Maps request bodies/parameters to fixture file paths for STU3 | +| `sandbox/src/mocks/` | Static JSON/text fixtures organised by FHIR version and endpoint | +| `sandbox/src/routes/objectStore.js` | Handles `/ObjectStore` routes for file upload/download | +| `sandbox/Dockerfile` | Container build — runs on port 9000 | + +## Common response headers + +`app.js` adds these to every response via an `onPreResponse` extension: +- `X-Correlation-ID` — echoed from the request's `x-correlation-id` header +- `X-Request-ID` — fixed value `58621d65-d5ad-4c3a-959f-0438e355990e-1` (except ObjectStore routes) + +## Route handler pattern + +Every route handler follows the same structure: + +```javascript +const mockResponseProvider = require('./services/mockResponseProvider') +const validationUtils = require('../common/validationUtils') + +function handleEndpoint(request, h) { + // 1. Define allowed business functions for this endpoint + const allowedBusinessFunctions = ["REFERRING_CLINICIAN", "SERVICE_PROVIDER_CLINICIAN"] + + // 2. Validate business function header — returns 403 if not in allowed list + const validationResult = validationUtils.validateBusinessFunction(request, h, allowedBusinessFunctions) + if (validationResult) return validationResult + + // 3. Use mockResponseProvider to map request → fixture file path + const { responsePath } = mockResponseProvider.getExampleResponseForX(request) + if (responsePath != null) { + return h.file(responsePath, { etagMethod: false }).code(200).type("application/fhir+json") + } + + // 4. Fall back to error fixture if no match + return h.file('stu3/STU3-SandboxErrorOutcome.json').code(422) +} + +// 5. Export as Hapi route array +module.exports = [ + { method: 'GET', path: '/FHIR/STU3/Resource/{id}', handler: (request, h) => handleEndpoint(request, h) } +] +``` + +## Mock response provider (`mockResponseProvider.js`) + +This module maps request inputs to response fixtures. Two main patterns: + +### POST endpoints (request body matching) +```javascript +mapExampleResponse(request, { + 'src/mocks/stu3/endpoint/requests/Request.json': 'stu3/endpoint/responses/Response.json' +}) +``` +Uses `lodash.isEqual` to deep-compare the incoming request body against stored example request bodies. If a match is found, returns the corresponding fixture path. + +### GET endpoints (parameter matching) +```javascript +mapExampleGetResponse(parameterValue, { + 'paramValue': 'stu3/endpoint/responses/Response.json' +}) +``` +Simple key-value lookup by a request parameter or header value. + +### Business function branching +Many handlers select different response maps based on the `nhsd-ers-business-function` header, returning different fixtures for different user roles. + +## Business function validation + +`validationUtils.validateBusinessFunction()` checks: +1. The `nhsd-ers-business-function` header is in the endpoint's allowed list → 403 if not +2. If `SERVICE_PROVIDER_CLINICIAN_ADMIN`, an `nhsd-ers-on-behalf-of-user-id` header must be present → 403 if missing +3. For all other roles, `nhsd-ers-on-behalf-of-user-id` must NOT be present → 403 if provided + +## Mock fixture organisation + +``` +sandbox/src/mocks/ +├── stu3/ +│ ├── createReferral/ +│ │ ├── requests/ # Example request bodies for matching +│ │ └── responses/ # Response fixtures +│ ├── retrieveWorklist/ +│ └── ... +├── r4/ +│ ├── retrieveBusinessFunctions/ +│ └── ... +└── NotFoundOutcome.txt # Generic 404 response +``` + +Fixtures serve as the **source of truth** for both the sandbox and the OAS spec examples — `make copy-examples` copies them into `specification/components/*/examples/`. + +## Running the sandbox + +- **Docker**: `make sandbox` (builds and runs on port 9100→9000) +- **Direct**: `cd sandbox && npm start` (runs on port 9000) +- **Debug**: `cd sandbox && npm run debug` (with Node.js inspector on port 9229) + +## Adding a new sandbox endpoint + +1. Create a response fixture in `sandbox/src/mocks/{stu3,r4}/endpointName/responses/` +2. If a POST endpoint, create example request bodies in `.../requests/` +3. Add a response mapping function in `mockResponseProvider.js` (or equivalent for R4) +4. Create a route handler file in `sandbox/src/routes/{stu3,r4}/endpointName.js` following the pattern above +5. Import and add the route to the array in `sandbox/src/routes/index.js` +6. Run `make copy-examples` then `make lint` to validate diff --git a/.github/instructions/specification.instructions.md b/.github/instructions/specification.instructions.md new file mode 100644 index 000000000..14b7593fb --- /dev/null +++ b/.github/instructions/specification.instructions.md @@ -0,0 +1,84 @@ +--- +applyTo: "specification/**" +description: "OAS spec workflow, examples pipeline, Redocly config, and how to add or modify API specification" +--- + +# OpenAPI Specification + +The API contract is defined in `specification/e-referrals-service-api.yaml` (OpenAPI 3.0) with components split by FHIR version. + +## Structure + +``` +specification/ +├── e-referrals-service-api.yaml # Root spec file (paths, info, servers) +└── components/ + ├── r4/ + │ ├── schemas/ # FHIR R4 JSON Schema definitions + │ └── examples/ # R4 example responses (copied from sandbox) + └── stu3/ + ├── schemas/ # FHIR STU3 JSON Schema definitions + └── examples/ # STU3 example responses (copied from sandbox) +``` + +## Examples pipeline + +**Sandbox fixtures are the source of truth for OAS examples.** The flow: + +1. Author/update mock response fixtures in `sandbox/src/mocks/{stu3,r4}/` +2. Run `make copy-examples` — this runs `scripts/copy_examples_from_sandbox.sh`, which copies fixtures into `specification/components/{r4,stu3}/examples/` +3. The spec YAML files `$ref` these example files +4. `make publish` bundles everything into a single dereferenced JSON file + +This means you should **never edit example files directly** in `specification/components/*/examples/` — they'll be overwritten. Edit the sandbox mocks instead. + +## Publishing workflow + +`make publish` runs this pipeline: + +1. `mkdir -p build` +2. `redocly bundle specification/e-referrals-service-api.yaml --dereferenced --remove-unused-components --ext json` — resolves all `$ref`s into a single file +3. Pipes through `scripts/set_version.py` — injects the calculated version number +4. Pipes through `scripts/populate_placeholders.py` — replaces `[[HYPERLINK_*]]` placeholders with actual URLs +5. Output: `build/e-referrals-service-api.json` + +## Linting + +`make lint` runs `redocly lint` using the config in `redocly.yaml`: +- Extends the `recommended` ruleset +- Disables `no-invalid-media-type-examples` and `tag-description` + +## Previewing docs + +`make serve` runs `redocly preview-docs` on port 5000 against the bundled spec. + +## Modifying the spec + +1. Edit `specification/e-referrals-service-api.yaml` for paths/operations, or component files for schemas +2. Keep schemas split by FHIR version in `components/{r4,stu3}/schemas/` +3. If adding new response examples, create the fixture in `sandbox/src/mocks/` first, then `make copy-examples` +4. Run `make lint` to validate +5. Run `make publish` to generate the bundled output +6. `make serve` to preview the rendered docs + +## Version management + +The version in the spec's `info.version` field is a placeholder — `scripts/set_version.py` replaces it during the publish step. + +Version is calculated automatically from **git commit messages** by `scripts/calculate_version.py`. Embed commands in commit messages to control versioning: + +| Command | Effect | +|---|---| +| `+major` | Increment the major version | +| `+minor` | Increment the minor version | +| `+setstatus ` | Set the prerelease status (e.g. `alpha`, `beta`) | +| `+clearstatus` | Clear the prerelease status | +| `+startversioning` | Reset version to `v1.0.0-alpha` | + +Example commit: `+minor APM-123 Add new endpoint for service requests` + +Without any command, the patch version increments automatically. + +## Placeholder substitution + +`scripts/populate_placeholders.py` replaces `[[HYPERLINK_*]]` tokens (e.g. `[[HYPERLINK_A004]]`, `[[HYPERLINK_A011]]`) in the bundled spec with markdown anchor links for the Developer Hub documentation. These map activity codes to their rendered API endpoint anchors. diff --git a/.github/instructions/testing.instructions.md b/.github/instructions/testing.instructions.md new file mode 100644 index 000000000..822dfc29c --- /dev/null +++ b/.github/instructions/testing.instructions.md @@ -0,0 +1,126 @@ +--- +applyTo: "tests/**" +description: "Test structure, Actor model, activity codes, SandboxTest base class, integration test setup, and how to add new tests" +--- + +# Test Structure + +Tests use **pytest** and live under `tests/`. Three suites: `sandbox/`, `integration/`, `smoke/`. + +## Test markers + +Defined in `pyproject.toml`: +- `sandbox` — sandbox tests (applied via `SandboxTest` base class) +- `integration_test` — integration tests against deployed environments +- `smoke_test` — health/status checks + +## Actor model (`tests/data.py`) + +The `Actor` enum models different e-RS user personas. Each actor has: + +| Property | Description | +|---|---| +| `user_id` | Simulated NHS user ID | +| `org_code` | ODS organisation code | +| `business_function` | e-RS business function (role) | +| `id_assurance_level` | IAL (identity assurance level, typically `"3"`) | +| `authentication_assurance_level` | AAL enum (`AAL3`, `AAL2`, `AAL1`) | +| `obo_user_id` | Optional on-behalf-of user ID (only for `SPCA`) | + +### Standard actors + +| Actor | Business function | ODS | Notes | +|---|---|---|---| +| `RC` | `REFERRING_CLINICIAN` | `D82106` | Primary care referrer | +| `RCA` | `REFERRING_CLINICIAN_ADMIN` | `D82106` | Referrer admin | +| `RA` | `REFERRING_ADMIN` | `D82106` | Referring admin | +| `SPC` | `SERVICE_PROVIDER_CLINICIAN` | `RCD` | Secondary care clinician | +| `SPA` | `SERVICE_PROVIDER_ADMIN` | `RCD` | Provider admin | +| `SPCA` | `SERVICE_PROVIDER_CLINICIAN_ADMIN` | `RCD` | Provider admin acting on behalf of another user | +| `RC_DEV` | `REFERRING_CLINICIAN` | `R69` | Dev/integration test user | +| `RC_INSUFFICIENT_IAL` | `REFERRING_CLINICIAN` | `D82106` | IAL=2, used for auth failure tests | +| `AAL2_USER` | `REFERRING_CLINICIAN` | `RCD` | AAL2 auth level | +| `AAL1_USER` | `REFERRING_CLINICIAN` | `RCD` | AAL1 auth level (should be rejected) | + +Helper method: `actor.is_referrer()` returns `True` for RC, RCA, RA business functions. + +### Header mapping (`RenamedHeader`) + +The `RenamedHeader` enum maps external header names to internal names — used by test fixtures to set correct headers when calling the sandbox. + +## Activity code naming convention + +Test files are named by **e-RS activity code**: `test_a030_retrieve_eRS_business_functions.py`, `test_a033_retrieve_healthcare_service.py`, etc. + +These codes (`a030`, `a033`, `a035`, ...) correspond to specific API operations defined in the e-RS service specification. When adding a new test file, use the activity code assigned to the endpoint in the e-RS documentation. + +## Sandbox tests (`tests/sandbox/`) + +### Running +```bash +make sandbox-tests +# or directly: +ENVIRONMENT=local SERVICE_BASE_PATH=localhost poetry run pytest -v tests/sandbox +``` +Requires the sandbox running locally on port 9100. + +### `SandboxTest` base class + +All sandbox test classes extend `SandboxTest` (in `tests/sandbox/SandboxTest.py`), which provides: + +**Required fixtures (abstract — must be implemented):** +- `endpoint_url` — the API path to test +- `http_method` — `HttpMethod` enum (GET, POST, PUT, etc.) +- `authorised_actors` — list of `Actor` values allowed to call this endpoint +- `default_headers` — headers to include in every request +- `call_endpoint` — function that sends the request and returns the response +- `allowed_business_functions` — list of business function strings permitted + +**Derived fixtures:** +- `unauthorised_actors` — automatically computed as all actors NOT in `authorised_actors` + +**Built-in tests (inherited automatically):** +- `test_unauthorised_business_functions` — verifies 403 for all unauthorised actors, checks the error message matches the expected `SANDBOX_ERROR:` format +- `test_with_correlation_id` — verifies `X-Correlation-ID` is echoed back in responses + +### Key conftest fixtures (`tests/sandbox/conftest.py`) + +- `sandbox_url` — resolves to `http://127.0.0.1:9100` locally or the deployed service URL +- `load_json(path)` — loads a JSON fixture from `sandbox/src/mocks/` +- `load_file(path)` — loads a binary fixture (e.g. PDF) +- `send_rest_request(method, url, actor, headers)` — sends an HTTP request with actor-appropriate headers + +### Assertion utilities (`tests/asserts.py`) + +- `assert_status_code(expected, actual)` — status code check with `pytest_check` +- `assert_response(expected_dict, actual_response)` — full JSON body comparison +- Generic header sets (`_generic_headers`, `_generic_file_headers`) define expected response headers + +## Integration tests (`tests/integration/`) + +### Running +Require a deployed Apigee environment. Env vars needed: +- `ENVIRONMENT`, `FULLY_QUALIFIED_SERVICE_NAME`, `SERVICE_BASE_PATH` +- `OAUTH_PROXY`, `OAUTH_BASE_URI` +- ASID-related variables + +### Files +- `test_user_restricted.py` — user-restricted OAuth flow, validates ODS/business function behaviour +- `test_app_restricted.py` — app-restricted (client credentials) flow +- `test_headers.py` — header validation across endpoints + +### Key dependency +Uses `pytest-nhsd-apim` for OAuth authenticators (`AuthorizationCodeAuthenticator`, `ClientCredentialsAuthenticator`) and Apigee API management (`ApigeeClient`, `ApiProductsAPI`). + +## Smoke tests (`tests/smoke/`) + +`test_status_endpoints.py` — basic `_ping` and `_status` health checks. + +## Adding a new test + +1. Identify the e-RS activity code for the endpoint +2. Create `tests/sandbox/{stu3,r4}/test_a{code}_{endpoint_name}.py` +3. Extend `SandboxTest`, implement all abstract fixtures +4. Define `authorised_actors` matching the sandbox route's `allowedBusinessFunctions` +5. The base class auto-tests unauthorised actors and correlation ID handling +6. Add endpoint-specific tests (response body, headers, status codes, edge cases) diff --git a/.github/prompts/add-context.prompt.md b/.github/prompts/add-context.prompt.md new file mode 100644 index 000000000..8fb11d3f9 --- /dev/null +++ b/.github/prompts/add-context.prompt.md @@ -0,0 +1,27 @@ +--- +description: "Add new context or facts to the repo's copilot-instructions.md. Use when: discovered something about the codebase worth recording, want to document a convention, add architectural context, or capture tribal knowledge for future developers." +agent: "agent" +tools: ["search", "editFiles"] +argument-hint: "Describe the context to add..." +--- + +The user wants to add new context or facts to the repository's Copilot instructions file at `.github/copilot-instructions.md`. + +## Your task + +1. Read the user's input — they will describe a fact, convention, architectural detail, or piece of tribal knowledge they want recorded. +2. Read the current `.github/copilot-instructions.md` to understand the existing structure and sections. +3. Determine where the new information best fits: + - If it extends an existing section, add it there + - If it's a new topic, create a new section in a logical position + - If it corrects existing information, update in place +4. Make the edit — keep the same tone and formatting as the rest of the file (concise, factual, bullet points or tables where appropriate). +5. Confirm what was added and where. + +## Rules + +- Do NOT duplicate information already present in the file. +- Do NOT restructure or reformat existing sections — only touch what's needed. +- Keep additions concise. This file is loaded into Copilot's context on every interaction, so brevity matters. +- If the user's input is vague, search the codebase to verify facts before adding them. +- If the information seems incorrect or contradicts the codebase, flag it to the user before adding. diff --git a/.github/prompts/overview.prompt.md b/.github/prompts/overview.prompt.md new file mode 100644 index 000000000..8643a3870 --- /dev/null +++ b/.github/prompts/overview.prompt.md @@ -0,0 +1,94 @@ +--- +description: "Explain this repo — architecture, workflows, dependencies, and how it relates to e-RS. Use when: new to the codebase, onboarding, wanting a quick overview, asking about e-RS core." +agent: "agent" +tools: ["search"] +--- + +You are an onboarding guide for the **e-Referrals Service (e-RS) FHIR API** repository. + +Start by giving a concise overview of the repo, then answer any follow-up questions. + +## Initial overview + +When first invoked, provide a short structured breakdown covering these areas: + +### 1. What this repo is + +This repo is the **API layer** for the NHS e-Referral Service. It does NOT contain the e-RS core application — it provides the public-facing FHIR API that third-party systems (GP clinical systems, provider systems) use to interact with e-RS. + +The relationship to e-RS core: +- This repo defines the **OpenAPI specification** (the contract) +- The **Apigee proxy** (`proxies/live/`) handles auth, header transformation, and rate limiting in front of the real e-RS backend +- The **sandbox** (`sandbox/`) is a mock server returning fixture data — it never touches the real backend +- The real e-RS backend is a separate system; this proxy forwards to it at `/ers-api` via a configured target server + +### 2. Key directories + +- `specification/` — OpenAPI 3.0 spec, split into `components/r4/` (FHIR R4) and `components/stu3/` (FHIR STU3) +- `proxies/live/` — Production Apigee proxy (~60 policies: OAuth, ASID, ODS allowlist, rate limiting, header swapping) +- `proxies/sandbox/` — Lightweight Apigee proxy (~11 policies, no auth) forwarding to the mock server +- `sandbox/` — Hapi.js (Node.js) mock server with static JSON fixtures in `sandbox/src/mocks/` +- `tests/` — Python pytest suites: `sandbox/`, `integration/`, `smoke/` +- `terraform/` — Apigee infrastructure-as-code +- `scripts/` — Build utilities, OAS validation, environment setup +- `azure/` — Azure DevOps CI/CD pipelines + +### 3. CI/CD and GitHub workflows + +- CI/CD runs on **Azure DevOps** (pipelines defined in `azure/`) +- `azure-build-pipeline.yml` — main build, triggered on tags and PRs +- `azure-pr-pipeline.yml` — PR validation +- `azure-release-pipeline.yml` — release deployment +- All extend shared templates from `NHSDigital/api-management-utils` +- The build bundles the OAS spec, assembles proxy bundles, and packages everything into `dist/` +- GitHub has `dependabot.yml` for dependency updates and PR/issue templates + +### 4. Dependency management + +**Python** (for tests and build scripts): +- Managed with **Poetry** (`pyproject.toml` / `poetry.lock`) +- Python ≥ 3.13 required +- Install: `poetry install` +- Key deps: `pytest`, `requests`, `pytest-nhsd-apim` (integration tests), `flake8` (linting) + +**Node.js — root** (for OAS tooling): +- `package.json` at repo root — only `@redocly/cli` for spec linting/bundling +- Install: `npm install` + +**Node.js — sandbox** (mock server): +- `sandbox/package.json` — `@hapi/hapi`, `@hapi/inert`, `lodash` +- Install: `cd sandbox && npm install` + +**All at once**: `make install` installs everything plus git hooks. + +### 5. Common tasks + +``` +make install # Install all deps +make lint # Lint spec + JS + XML proxies + Python +make publish # Bundle OAS spec → build/e-referrals-service-api.json +make serve # Preview spec docs on port 5000 +make sandbox # Build & run sandbox Docker container +make sandbox-tests # Run sandbox pytest suite +make setup-environment # Bootstrap dev environment (pyenv, Python 3.13) +``` + +## Follow-up questions + +After the initial overview, answer questions about: +- How the Apigee proxy request flow works (auth chain, header swapping, R4 vs STU3 branching) +- How the sandbox mock server is structured +- How tests are organised and run +- How the OAS spec is authored, validated, and published +- How this API relates to the e-RS core backend +- How to add new endpoints, proxy policies, or test cases +- Branching strategy (develop → PRs; master is release-only) + +Use the repo's context files to provide accurate, specific answers: +- `.github/copilot-instructions.md` — high-level overview (always loaded) +- `.github/instructions/proxy.instructions.md` — proxy architecture deep-dive +- `.github/instructions/sandbox.instructions.md` — sandbox patterns and mock data +- `.github/instructions/testing.instructions.md` — test structure, Actor model, activity codes +- `.github/instructions/specification.instructions.md` — OAS spec workflow and examples pipeline + +Read the relevant instruction file before answering deep questions. Search the codebase when needed rather than guessing. diff --git a/.github/prompts/release.prompt.md b/.github/prompts/release.prompt.md new file mode 100644 index 000000000..1c2b95c7f --- /dev/null +++ b/.github/prompts/release.prompt.md @@ -0,0 +1,85 @@ +--- +description: "Walk through the release process for this repo. Use when: preparing a release, publishing the OAS spec, deploying to Apigee, or troubleshooting the build pipeline." +agent: "agent" +tools: ["search", "terminal"] +--- + +You are a release guide for the **e-Referrals Service API** repository. + +Walk the user through the release process step by step. Adapt based on where they are — they may need the full flow or just a specific step. + +## Environment prerequisites + +Before releasing, the dev environment must be set up. If the user hasn't done this or is having issues: + +1. `make clean-environment` — removes the pyenv `apigee` virtual environment +2. Open a **new terminal** +3. `make setup-environment` — installs pyenv, Python 3.13, creates the `apigee` venv, installs Poetry +4. Open a **new terminal** +5. `pyenv version` — should show `apigee`. If not, repeat from step 1 +6. `make install` — installs Node deps (root + sandbox) and Poetry deps + git hooks + +## Release steps + +### 1. Validate the spec + +```bash +make lint +``` + +This runs: +- `redocly lint` on the OAS spec +- ESLint on the sandbox JavaScript +- `xml_validator.py` on the Apigee proxy XML +- `flake8` on Python files +- `poetry check` on pyproject.toml + +All must pass before proceeding. + +### 2. Publish the OAS spec + +```bash +make publish +``` + +This bundles the spec into `build/e-referrals-service-api.json`: +1. Redocly CLI resolves all `$ref`s, dereferences, and removes unused components +2. `scripts/set_version.py` calculates the version from git commit messages and injects it into `info.version` +3. `scripts/populate_placeholders.py` replaces `[[HYPERLINK_*]]` tokens with Developer Hub links + +The version is derived from commit message commands: +- `+major` — bump major version +- `+minor` — bump minor version +- `+setstatus ` — set prerelease label (e.g. `alpha`) +- `+clearstatus` — remove prerelease label +- No command → patch increment + +### 3. Full release build + +```bash +make release +``` + +This runs `clean` → `publish` → `build_proxy` → packages everything into `dist/`: +- The bundled OAS JSON +- Both proxy bundles (live + sandbox with hosted target files) +- Test suites +- Poetry config for test dependencies + +### 4. Deployment + +Deployment is **not triggered by developers**. After the release build is complete: +- The Azure DevOps release pipeline is triggered by a `v*` tag push (handled by the release management process, not individual developers) +- The pipeline deploys to Apigee environments progressively (internal-dev → internal-qa → sandbox → production) with manual approval gates + +## Sibling repo + +The same process applies to **`e-referrals-service-patient-care-api`** — same structure, same make targets, same pipeline setup. + +## Troubleshooting + +If asked about issues, check: +- `pyenv version` not showing `apigee` → re-run setup in a new terminal +- `make publish` failing → check `make lint` passes first +- Version not incrementing → check commit messages include version commands +- Missing examples → run `make copy-examples` before `make publish` diff --git a/sandbox/src/routes/stu3/services/mockResponseProvider.js b/sandbox/src/routes/stu3/services/mockResponseProvider.js index 4fa4d096c..3e31b22f5 100644 --- a/sandbox/src/routes/stu3/services/mockResponseProvider.js +++ b/sandbox/src/routes/stu3/services/mockResponseProvider.js @@ -397,7 +397,9 @@ module.exports = { 'src/mocks/stu3/cancelReferral/requests/RaisedInError.json': 'stu3/cancelReferral/responses/CancelledReferralRaisedInError.json', 'src/mocks/stu3/cancelReferral/requests/ReferrerCancellation.json': 'stu3/cancelReferral/responses/CancelledBookedReferralReferrerCancellation.json', 'src/mocks/stu3/cancelReferral/requests/NoLongerRequired.json': 'stu3/cancelReferral/responses/CancelledReferralWithCancelledBookingNoLongerRequired.json', - 'src/mocks/stu3/cancelReferral/requests/IntendPrivateWithComment.json': 'stu3/cancelReferral/responses/CancelledReferralResolvedDeferralIntendPrivateWithComment.json' + 'src/mocks/stu3/cancelReferral/requests/IntendPrivateWithComment.json': 'stu3/cancelReferral/responses/CancelledReferralResolvedDeferralIntendPrivateWithComment.json', + 'src/mocks/stu3/cancelReferral/requests/bookedOutsideCabWithoutComment.json': 'stu3/cancelReferral/responses/CancelledReferralBookedOutsideCabWithoutComment.json', + 'src/mocks/stu3/cancelReferral/requests/outpatientService.json': 'stu3/cancelReferral/responses/CancelledReferralOutpatientService.json' } return mapExampleResponse(request, responseMap); diff --git a/tests/conftest.py b/tests/conftest.py index b452f4c2e..adf47ff5d 100644 --- a/tests/conftest.py +++ b/tests/conftest.py @@ -2,7 +2,6 @@ import pytest import pytest_asyncio import warnings -import json from uuid import uuid4 from typing import Collection, Callable, Generator, Dict @@ -80,12 +79,6 @@ def asid(is_mocked_environment): ) -@pytest.fixture(scope="session") -def apim_app_flow_vars(allowListodsCode=None): - if allowListodsCode is not None: - return {"ers": {"allowListodsCode": allowListodsCode}} - - @pytest.fixture(scope="session") def referring_clinician(is_mocked_environment): return Actor.RC_DEV if is_mocked_environment else Actor.RC @@ -284,18 +277,9 @@ async def _make_product(product_scopes, additional_attributes=None): @pytest_asyncio.fixture -async def user_restricted_app( - client, make_app, user_restricted_product, asid, apim_app_flow_vars -): +async def user_restricted_app(client, make_app, user_restricted_product, asid): # Setup - if apim_app_flow_vars is not None: - odslist = json.dumps({"ers": {"allowListodsCode": apim_app_flow_vars}}) - app = await make_app( - user_restricted_product, - {"asid": asid, "apim-app-flow-vars": odslist}, - ) - else: - app = await make_app(user_restricted_product, {"asid": asid}) + app = await make_app(user_restricted_product, {"asid": asid}) appName = app["name"] print(f"App created: {appName}") diff --git a/tests/integration/test_user_restricted.py b/tests/integration/test_user_restricted.py index 8d4af58ec..052e5f57a 100644 --- a/tests/integration/test_user_restricted.py +++ b/tests/integration/test_user_restricted.py @@ -32,11 +32,11 @@ class TestUserRestricted: @pytest.mark.asyncio @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user, apim_app_flow_vars ", + "endpoint_url, is_fhir_4, user", [ - ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("", False, Actor.RC_DEV), + ("/FHIR/R4/", True, Actor.RC_DEV), + ("/FHIR/STU3/", False, Actor.RC_DEV), ], ) async def test_user_restricted_valid_ods_code( @@ -47,7 +47,6 @@ async def test_user_restricted_valid_ods_code( asid, endpoint_url, is_fhir_4, - apim_app_flow_vars, ): access_code = await authenticate_user(user) @@ -73,213 +72,3 @@ async def test_user_restricted_valid_ods_code( assert ( response.status_code == 200 ), "Expected a 200 when accessing the api but got " + str(response.status_code) - - @pytest.mark.asyncio - @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", - [ - ("", False, Actor.RC_DEV, ["invalid_code"]), - ("/FHIR/R4/", True, Actor.RC_DEV, ["invalid_code"]), - ("/FHIR/STU3/", False, Actor.RC_DEV, ["invalid_code"]), - ], - ) - async def test_user_restricted_invalid_ods_code( - self, - authenticate_user, - service_url, - user: Actor, - asid, - endpoint_url, - is_fhir_4, - apim_app_flow_vars, - ): - access_code = await authenticate_user(user) - - client_request_headers = { - _HEADER_ECHO: "", # enable echo target - _HEADER_AUTHORIZATION: "Bearer " + access_code, - _HEADER_REQUEST_ID: "DUMMY-VALUE", - RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, - RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, - RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, - RenamedHeader.ODS_CODE.original: user.org_code, - RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, - RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, - RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, - } - - # Make the API call - response = requests.get( - f"{service_url}{endpoint_url}", headers=client_request_headers - ) - # Verify the status - assert ( - response.status_code == 403 - ), "Expected a 403 when accessing the api but got " + str(response.status_code) - # Verify the OperationOutcome payload - response_data = response.json() - assert response_data["resourceType"] == "OperationOutcome" - assert response_data["meta"]["lastUpdated"] is not None - assert len(response_data["meta"]["profile"]) == 1 - assert response_data["meta"]["profile"][0] == ( - "https://www.hl7.org/fhir/R4/operationoutcome.html" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ) - assert len(response_data["issue"]) == 1 - issue = response_data["issue"][0] - assert issue["severity"] == "error" - assert issue["code"] == "forbidden" if is_fhir_4 else "forbidden" - assert issue["diagnostics"] == ( - "Unauthorised ODS code provided in NHSD-End-User-Organisation-ODS header" - ) - assert len(issue["details"]["coding"]) == 1 - issue_details = issue["details"]["coding"][0] - assert ( - issue_details["system"] - == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ) - assert issue_details["code"] == "ACCESS_DENIED" if is_fhir_4 else "NO_ACCESS" - - @pytest.mark.asyncio - @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", - [ - ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ], - ) - async def test_user_restricted_missing_ods_header( - self, - authenticate_user, - service_url, - user: Actor, - asid, - endpoint_url, - is_fhir_4, - apim_app_flow_vars, - ): - access_code = await authenticate_user(user) - - client_request_headers = { - _HEADER_ECHO: "", # enable echo target - _HEADER_AUTHORIZATION: "Bearer " + access_code, - _HEADER_REQUEST_ID: "DUMMY-VALUE", - RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, - RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, - RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, - RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, - RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, - RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, - } - - # Make the API call - response = requests.get( - f"{service_url}{endpoint_url}", headers=client_request_headers - ) - # Verify the status - assert ( - response.status_code == 400 - ), "Expected a 400 when accessing the api but got " + str(response.status_code) - # Verify the OperationOutcome payload - response_data = response.json() - assert response_data["resourceType"] == "OperationOutcome" - assert response_data["meta"]["lastUpdated"] is not None - assert len(response_data["meta"]["profile"]) == 1 - assert response_data["meta"]["profile"][0] == ( - "https://www.hl7.org/fhir/R4/operationoutcome.html" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ) - assert len(response_data["issue"]) == 1 - issue = response_data["issue"][0] - assert issue["severity"] == "error" - assert issue["code"] == "required" if is_fhir_4 else "required" - assert issue["diagnostics"] == ( - "Missing or Empty NHSD-End-User-Organisation-ODS header." - ) - assert len(issue["details"]["coding"]) == 1 - issue_details = issue["details"]["coding"][0] - assert ( - issue_details["system"] - == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ) - assert ( - issue_details["code"] == "MISSING_HEADER" if is_fhir_4 else "MISSING_HEADER" - ) - - @pytest.mark.asyncio - @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", - [ - ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ], - ) - async def test_user_restricted_missing_ods_code( - self, - authenticate_user, - service_url, - user: Actor, - asid, - endpoint_url, - is_fhir_4, - apim_app_flow_vars, - ): - access_code = await authenticate_user(user) - - client_request_headers = { - _HEADER_ECHO: "", # enable echo target - _HEADER_AUTHORIZATION: "Bearer " + access_code, - _HEADER_REQUEST_ID: "DUMMY-VALUE", - RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, - RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, - RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, - RenamedHeader.ODS_CODE.original: "", - RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, - RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, - RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, - } - - # Make the API call - response = requests.get( - f"{service_url}{endpoint_url}", headers=client_request_headers - ) - # Verify the status - assert ( - response.status_code == 400 - ), "Expected a 400 when accessing the api but got " + str(response.status_code) - # Verify the OperationOutcome payload - response_data = response.json() - assert response_data["resourceType"] == "OperationOutcome" - assert response_data["meta"]["lastUpdated"] is not None - assert len(response_data["meta"]["profile"]) == 1 - assert response_data["meta"]["profile"][0] == ( - "https://www.hl7.org/fhir/R4/operationoutcome.html" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ) - assert len(response_data["issue"]) == 1 - issue = response_data["issue"][0] - assert issue["severity"] == "error" - assert issue["code"] == "required" if is_fhir_4 else "required" - assert issue["diagnostics"] == ( - "Missing or Empty NHSD-End-User-Organisation-ODS header." - ) - assert len(issue["details"]["coding"]) == 1 - issue_details = issue["details"]["coding"][0] - assert ( - issue_details["system"] - == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ) - assert ( - issue_details["code"] == "MISSING_HEADER" if is_fhir_4 else "MISSING_HEADER" - ) From dd73c2e6efe7830f17e71def689babe21378543c Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 27 May 2026 10:54:56 +0000 Subject: [PATCH 49/55] Remove unused imports from test_user_restricted.py (F401) --- tests/integration/test_user_restricted.py | 219 +++++++++++++++++++++- 1 file changed, 215 insertions(+), 4 deletions(-) diff --git a/tests/integration/test_user_restricted.py b/tests/integration/test_user_restricted.py index 052e5f57a..8d4af58ec 100644 --- a/tests/integration/test_user_restricted.py +++ b/tests/integration/test_user_restricted.py @@ -32,11 +32,11 @@ class TestUserRestricted: @pytest.mark.asyncio @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user", + "endpoint_url, is_fhir_4, user, apim_app_flow_vars ", [ - ("", False, Actor.RC_DEV), - ("/FHIR/R4/", True, Actor.RC_DEV), - ("/FHIR/STU3/", False, Actor.RC_DEV), + ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), ], ) async def test_user_restricted_valid_ods_code( @@ -47,6 +47,7 @@ async def test_user_restricted_valid_ods_code( asid, endpoint_url, is_fhir_4, + apim_app_flow_vars, ): access_code = await authenticate_user(user) @@ -72,3 +73,213 @@ async def test_user_restricted_valid_ods_code( assert ( response.status_code == 200 ), "Expected a 200 when accessing the api but got " + str(response.status_code) + + @pytest.mark.asyncio + @pytest.mark.parametrize( + "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", + [ + ("", False, Actor.RC_DEV, ["invalid_code"]), + ("/FHIR/R4/", True, Actor.RC_DEV, ["invalid_code"]), + ("/FHIR/STU3/", False, Actor.RC_DEV, ["invalid_code"]), + ], + ) + async def test_user_restricted_invalid_ods_code( + self, + authenticate_user, + service_url, + user: Actor, + asid, + endpoint_url, + is_fhir_4, + apim_app_flow_vars, + ): + access_code = await authenticate_user(user) + + client_request_headers = { + _HEADER_ECHO: "", # enable echo target + _HEADER_AUTHORIZATION: "Bearer " + access_code, + _HEADER_REQUEST_ID: "DUMMY-VALUE", + RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, + RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, + RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, + RenamedHeader.ODS_CODE.original: user.org_code, + RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, + RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, + RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, + } + + # Make the API call + response = requests.get( + f"{service_url}{endpoint_url}", headers=client_request_headers + ) + # Verify the status + assert ( + response.status_code == 403 + ), "Expected a 403 when accessing the api but got " + str(response.status_code) + # Verify the OperationOutcome payload + response_data = response.json() + assert response_data["resourceType"] == "OperationOutcome" + assert response_data["meta"]["lastUpdated"] is not None + assert len(response_data["meta"]["profile"]) == 1 + assert response_data["meta"]["profile"][0] == ( + "https://www.hl7.org/fhir/R4/operationoutcome.html" + if is_fhir_4 + else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ) + assert len(response_data["issue"]) == 1 + issue = response_data["issue"][0] + assert issue["severity"] == "error" + assert issue["code"] == "forbidden" if is_fhir_4 else "forbidden" + assert issue["diagnostics"] == ( + "Unauthorised ODS code provided in NHSD-End-User-Organisation-ODS header" + ) + assert len(issue["details"]["coding"]) == 1 + issue_details = issue["details"]["coding"][0] + assert ( + issue_details["system"] + == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" + if is_fhir_4 + else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ) + assert issue_details["code"] == "ACCESS_DENIED" if is_fhir_4 else "NO_ACCESS" + + @pytest.mark.asyncio + @pytest.mark.parametrize( + "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", + [ + ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ], + ) + async def test_user_restricted_missing_ods_header( + self, + authenticate_user, + service_url, + user: Actor, + asid, + endpoint_url, + is_fhir_4, + apim_app_flow_vars, + ): + access_code = await authenticate_user(user) + + client_request_headers = { + _HEADER_ECHO: "", # enable echo target + _HEADER_AUTHORIZATION: "Bearer " + access_code, + _HEADER_REQUEST_ID: "DUMMY-VALUE", + RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, + RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, + RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, + RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, + RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, + RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, + } + + # Make the API call + response = requests.get( + f"{service_url}{endpoint_url}", headers=client_request_headers + ) + # Verify the status + assert ( + response.status_code == 400 + ), "Expected a 400 when accessing the api but got " + str(response.status_code) + # Verify the OperationOutcome payload + response_data = response.json() + assert response_data["resourceType"] == "OperationOutcome" + assert response_data["meta"]["lastUpdated"] is not None + assert len(response_data["meta"]["profile"]) == 1 + assert response_data["meta"]["profile"][0] == ( + "https://www.hl7.org/fhir/R4/operationoutcome.html" + if is_fhir_4 + else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ) + assert len(response_data["issue"]) == 1 + issue = response_data["issue"][0] + assert issue["severity"] == "error" + assert issue["code"] == "required" if is_fhir_4 else "required" + assert issue["diagnostics"] == ( + "Missing or Empty NHSD-End-User-Organisation-ODS header." + ) + assert len(issue["details"]["coding"]) == 1 + issue_details = issue["details"]["coding"][0] + assert ( + issue_details["system"] + == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" + if is_fhir_4 + else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ) + assert ( + issue_details["code"] == "MISSING_HEADER" if is_fhir_4 else "MISSING_HEADER" + ) + + @pytest.mark.asyncio + @pytest.mark.parametrize( + "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", + [ + ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ], + ) + async def test_user_restricted_missing_ods_code( + self, + authenticate_user, + service_url, + user: Actor, + asid, + endpoint_url, + is_fhir_4, + apim_app_flow_vars, + ): + access_code = await authenticate_user(user) + + client_request_headers = { + _HEADER_ECHO: "", # enable echo target + _HEADER_AUTHORIZATION: "Bearer " + access_code, + _HEADER_REQUEST_ID: "DUMMY-VALUE", + RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, + RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, + RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, + RenamedHeader.ODS_CODE.original: "", + RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, + RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, + RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, + } + + # Make the API call + response = requests.get( + f"{service_url}{endpoint_url}", headers=client_request_headers + ) + # Verify the status + assert ( + response.status_code == 400 + ), "Expected a 400 when accessing the api but got " + str(response.status_code) + # Verify the OperationOutcome payload + response_data = response.json() + assert response_data["resourceType"] == "OperationOutcome" + assert response_data["meta"]["lastUpdated"] is not None + assert len(response_data["meta"]["profile"]) == 1 + assert response_data["meta"]["profile"][0] == ( + "https://www.hl7.org/fhir/R4/operationoutcome.html" + if is_fhir_4 + else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" + ) + assert len(response_data["issue"]) == 1 + issue = response_data["issue"][0] + assert issue["severity"] == "error" + assert issue["code"] == "required" if is_fhir_4 else "required" + assert issue["diagnostics"] == ( + "Missing or Empty NHSD-End-User-Organisation-ODS header." + ) + assert len(issue["details"]["coding"]) == 1 + issue_details = issue["details"]["coding"][0] + assert ( + issue_details["system"] + == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" + if is_fhir_4 + else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" + ) + assert ( + issue_details["code"] == "MISSING_HEADER" if is_fhir_4 else "MISSING_HEADER" + ) From 9db13dca976c67a6d51efe05301bfb7c97972dbb Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 27 May 2026 11:14:25 +0000 Subject: [PATCH 50/55] Remove EUO allowlist tests and apim_app_flow_vars references --- tests/integration/test_user_restricted.py | 223 +--------------------- 1 file changed, 5 insertions(+), 218 deletions(-) diff --git a/tests/integration/test_user_restricted.py b/tests/integration/test_user_restricted.py index 8d4af58ec..21bd11323 100644 --- a/tests/integration/test_user_restricted.py +++ b/tests/integration/test_user_restricted.py @@ -1,8 +1,6 @@ import pytest import requests -from requests import Response -from tests.data import RenamedHeader, Actor, UserAuthenticationLevel -from tests.asserts import assert_ok_response +from tests.data import RenamedHeader, Actor _HEADER_AUTHORIZATION = "Authorization" _HEADER_ECHO = "echo" # enable echo target @@ -32,11 +30,11 @@ class TestUserRestricted: @pytest.mark.asyncio @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user, apim_app_flow_vars ", + "endpoint_url, is_fhir_4, user", [ - ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), + ("", False, Actor.RC_DEV), + ("/FHIR/R4/", True, Actor.RC_DEV), + ("/FHIR/STU3/", False, Actor.RC_DEV), ], ) async def test_user_restricted_valid_ods_code( @@ -47,7 +45,6 @@ async def test_user_restricted_valid_ods_code( asid, endpoint_url, is_fhir_4, - apim_app_flow_vars, ): access_code = await authenticate_user(user) @@ -73,213 +70,3 @@ async def test_user_restricted_valid_ods_code( assert ( response.status_code == 200 ), "Expected a 200 when accessing the api but got " + str(response.status_code) - - @pytest.mark.asyncio - @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", - [ - ("", False, Actor.RC_DEV, ["invalid_code"]), - ("/FHIR/R4/", True, Actor.RC_DEV, ["invalid_code"]), - ("/FHIR/STU3/", False, Actor.RC_DEV, ["invalid_code"]), - ], - ) - async def test_user_restricted_invalid_ods_code( - self, - authenticate_user, - service_url, - user: Actor, - asid, - endpoint_url, - is_fhir_4, - apim_app_flow_vars, - ): - access_code = await authenticate_user(user) - - client_request_headers = { - _HEADER_ECHO: "", # enable echo target - _HEADER_AUTHORIZATION: "Bearer " + access_code, - _HEADER_REQUEST_ID: "DUMMY-VALUE", - RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, - RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, - RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, - RenamedHeader.ODS_CODE.original: user.org_code, - RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, - RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, - RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, - } - - # Make the API call - response = requests.get( - f"{service_url}{endpoint_url}", headers=client_request_headers - ) - # Verify the status - assert ( - response.status_code == 403 - ), "Expected a 403 when accessing the api but got " + str(response.status_code) - # Verify the OperationOutcome payload - response_data = response.json() - assert response_data["resourceType"] == "OperationOutcome" - assert response_data["meta"]["lastUpdated"] is not None - assert len(response_data["meta"]["profile"]) == 1 - assert response_data["meta"]["profile"][0] == ( - "https://www.hl7.org/fhir/R4/operationoutcome.html" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ) - assert len(response_data["issue"]) == 1 - issue = response_data["issue"][0] - assert issue["severity"] == "error" - assert issue["code"] == "forbidden" if is_fhir_4 else "forbidden" - assert issue["diagnostics"] == ( - "Unauthorised ODS code provided in NHSD-End-User-Organisation-ODS header" - ) - assert len(issue["details"]["coding"]) == 1 - issue_details = issue["details"]["coding"][0] - assert ( - issue_details["system"] - == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ) - assert issue_details["code"] == "ACCESS_DENIED" if is_fhir_4 else "NO_ACCESS" - - @pytest.mark.asyncio - @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", - [ - ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ], - ) - async def test_user_restricted_missing_ods_header( - self, - authenticate_user, - service_url, - user: Actor, - asid, - endpoint_url, - is_fhir_4, - apim_app_flow_vars, - ): - access_code = await authenticate_user(user) - - client_request_headers = { - _HEADER_ECHO: "", # enable echo target - _HEADER_AUTHORIZATION: "Bearer " + access_code, - _HEADER_REQUEST_ID: "DUMMY-VALUE", - RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, - RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, - RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, - RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, - RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, - RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, - } - - # Make the API call - response = requests.get( - f"{service_url}{endpoint_url}", headers=client_request_headers - ) - # Verify the status - assert ( - response.status_code == 400 - ), "Expected a 400 when accessing the api but got " + str(response.status_code) - # Verify the OperationOutcome payload - response_data = response.json() - assert response_data["resourceType"] == "OperationOutcome" - assert response_data["meta"]["lastUpdated"] is not None - assert len(response_data["meta"]["profile"]) == 1 - assert response_data["meta"]["profile"][0] == ( - "https://www.hl7.org/fhir/R4/operationoutcome.html" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ) - assert len(response_data["issue"]) == 1 - issue = response_data["issue"][0] - assert issue["severity"] == "error" - assert issue["code"] == "required" if is_fhir_4 else "required" - assert issue["diagnostics"] == ( - "Missing or Empty NHSD-End-User-Organisation-ODS header." - ) - assert len(issue["details"]["coding"]) == 1 - issue_details = issue["details"]["coding"][0] - assert ( - issue_details["system"] - == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ) - assert ( - issue_details["code"] == "MISSING_HEADER" if is_fhir_4 else "MISSING_HEADER" - ) - - @pytest.mark.asyncio - @pytest.mark.parametrize( - "endpoint_url, is_fhir_4, user ,apim_app_flow_vars", - [ - ("", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/R4/", True, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ("/FHIR/STU3/", False, Actor.RC_DEV, [Actor.RC_DEV.org_code]), - ], - ) - async def test_user_restricted_missing_ods_code( - self, - authenticate_user, - service_url, - user: Actor, - asid, - endpoint_url, - is_fhir_4, - apim_app_flow_vars, - ): - access_code = await authenticate_user(user) - - client_request_headers = { - _HEADER_ECHO: "", # enable echo target - _HEADER_AUTHORIZATION: "Bearer " + access_code, - _HEADER_REQUEST_ID: "DUMMY-VALUE", - RenamedHeader.REFERRAL_ID.original: _EXPECTED_REFERRAL_ID, - RenamedHeader.CORRELATION_ID.original: _EXPECTED_CORRELATION_ID, - RenamedHeader.BUSINESS_FUNCTION.original: user.business_function, - RenamedHeader.ODS_CODE.original: "", - RenamedHeader.FILENAME.original: _EXPECTED_FILENAME, - RenamedHeader.COMM_RULE_ORG.original: _EXPECTED_COMM_RULE_ORG, - RenamedHeader.OBO_USER_ID.original: _EXPECTED_OBO_USER_ID, - } - - # Make the API call - response = requests.get( - f"{service_url}{endpoint_url}", headers=client_request_headers - ) - # Verify the status - assert ( - response.status_code == 400 - ), "Expected a 400 when accessing the api but got " + str(response.status_code) - # Verify the OperationOutcome payload - response_data = response.json() - assert response_data["resourceType"] == "OperationOutcome" - assert response_data["meta"]["lastUpdated"] is not None - assert len(response_data["meta"]["profile"]) == 1 - assert response_data["meta"]["profile"][0] == ( - "https://www.hl7.org/fhir/R4/operationoutcome.html" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/StructureDefinition/eRS-OperationOutcome-1" - ) - assert len(response_data["issue"]) == 1 - issue = response_data["issue"][0] - assert issue["severity"] == "error" - assert issue["code"] == "required" if is_fhir_4 else "required" - assert issue["diagnostics"] == ( - "Missing or Empty NHSD-End-User-Organisation-ODS header." - ) - assert len(issue["details"]["coding"]) == 1 - issue_details = issue["details"]["coding"][0] - assert ( - issue_details["system"] - == "https://fhir.nhs.uk/CodeSystem/NHSD-API-ErrorOrWarningCode" - if is_fhir_4 - else "https://fhir.nhs.uk/STU3/CodeSystem/eRS-APIErrorCode-1" - ) - assert ( - issue_details["code"] == "MISSING_HEADER" if is_fhir_4 else "MISSING_HEADER" - ) From 6e11564d07017b8e6827185b9a629e888b241ce9 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Fri, 29 May 2026 14:41:12 +0000 Subject: [PATCH 51/55] fix: update vulnerable dependencies - lxml: ^5.1.0 -> ^6.1.0 (CVE fix, earliest fixed version 6.1.0) - pytest: ^8.4.2 -> ^9.0.3 (CVE fix, earliest fixed version 9.0.3) - werkzeug: add >=3.1.6 (CVE fix, earliest fixed version 3.1.6) - openapi-core: ^0.19.5 -> ^0.20.0 (unblock werkzeug update) - pytest-nhsd-apim: ^5.0.6 -> ^6.0.0 (unblock lxml and pytest updates) --- poetry.lock | 348 +++++++++++++++++++++++++------------------------ pyproject.toml | 9 +- 2 files changed, 181 insertions(+), 176 deletions(-) diff --git a/poetry.lock b/poetry.lock index e389e8e5e..8c07ac2ae 100644 --- a/poetry.lock +++ b/poetry.lock @@ -709,144 +709,146 @@ files = [ [[package]] name = "lxml" -version = "5.4.0" +version = "6.1.1" description = "Powerful and Pythonic XML processing library combining libxml2/libxslt with the ElementTree API." optional = false -python-versions = ">=3.6" +python-versions = ">=3.8" groups = ["main", "dev"] files = [ - {file = "lxml-5.4.0-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:e7bc6df34d42322c5289e37e9971d6ed114e3776b45fa879f734bded9d1fea9c"}, - {file = "lxml-5.4.0-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:6854f8bd8a1536f8a1d9a3655e6354faa6406621cf857dc27b681b69860645c7"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:696ea9e87442467819ac22394ca36cb3d01848dad1be6fac3fb612d3bd5a12cf"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:6ef80aeac414f33c24b3815ecd560cee272786c3adfa5f31316d8b349bfade28"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:3b9c2754cef6963f3408ab381ea55f47dabc6f78f4b8ebb0f0b25cf1ac1f7609"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:7a62cc23d754bb449d63ff35334acc9f5c02e6dae830d78dab4dd12b78a524f4"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:8f82125bc7203c5ae8633a7d5d20bcfdff0ba33e436e4ab0abc026a53a8960b7"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_28_aarch64.whl", hash = "sha256:b67319b4aef1a6c56576ff544b67a2a6fbd7eaee485b241cabf53115e8908b8f"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_28_ppc64le.whl", hash = "sha256:a8ef956fce64c8551221f395ba21d0724fed6b9b6242ca4f2f7beb4ce2f41997"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_28_s390x.whl", hash = "sha256:0a01ce7d8479dce84fc03324e3b0c9c90b1ece9a9bb6a1b6c9025e7e4520e78c"}, - {file = "lxml-5.4.0-cp310-cp310-manylinux_2_28_x86_64.whl", hash = "sha256:91505d3ddebf268bb1588eb0f63821f738d20e1e7f05d3c647a5ca900288760b"}, - {file = "lxml-5.4.0-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:a3bcdde35d82ff385f4ede021df801b5c4a5bcdfb61ea87caabcebfc4945dc1b"}, - {file = "lxml-5.4.0-cp310-cp310-musllinux_1_2_ppc64le.whl", hash = "sha256:aea7c06667b987787c7d1f5e1dfcd70419b711cdb47d6b4bb4ad4b76777a0563"}, - {file = "lxml-5.4.0-cp310-cp310-musllinux_1_2_s390x.whl", hash = "sha256:a7fb111eef4d05909b82152721a59c1b14d0f365e2be4c742a473c5d7372f4f5"}, - {file = "lxml-5.4.0-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:43d549b876ce64aa18b2328faff70f5877f8c6dede415f80a2f799d31644d776"}, - {file = "lxml-5.4.0-cp310-cp310-win32.whl", hash = "sha256:75133890e40d229d6c5837b0312abbe5bac1c342452cf0e12523477cd3aa21e7"}, - {file = "lxml-5.4.0-cp310-cp310-win_amd64.whl", hash = "sha256:de5b4e1088523e2b6f730d0509a9a813355b7f5659d70eb4f319c76beea2e250"}, - {file = "lxml-5.4.0-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:98a3912194c079ef37e716ed228ae0dcb960992100461b704aea4e93af6b0bb9"}, - {file = "lxml-5.4.0-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:0ea0252b51d296a75f6118ed0d8696888e7403408ad42345d7dfd0d1e93309a7"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:b92b69441d1bd39f4940f9eadfa417a25862242ca2c396b406f9272ef09cdcaa"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:20e16c08254b9b6466526bc1828d9370ee6c0d60a4b64836bc3ac2917d1e16df"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7605c1c32c3d6e8c990dd28a0970a3cbbf1429d5b92279e37fda05fb0c92190e"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:ecf4c4b83f1ab3d5a7ace10bafcb6f11df6156857a3c418244cef41ca9fa3e44"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:0cef4feae82709eed352cd7e97ae062ef6ae9c7b5dbe3663f104cd2c0e8d94ba"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_28_aarch64.whl", hash = "sha256:df53330a3bff250f10472ce96a9af28628ff1f4efc51ccba351a8820bca2a8ba"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_28_ppc64le.whl", hash = "sha256:aefe1a7cb852fa61150fcb21a8c8fcea7b58c4cb11fbe59c97a0a4b31cae3c8c"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_28_s390x.whl", hash = "sha256:ef5a7178fcc73b7d8c07229e89f8eb45b2908a9238eb90dcfc46571ccf0383b8"}, - {file = "lxml-5.4.0-cp311-cp311-manylinux_2_28_x86_64.whl", hash = "sha256:d2ed1b3cb9ff1c10e6e8b00941bb2e5bb568b307bfc6b17dffbbe8be5eecba86"}, - {file = "lxml-5.4.0-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:72ac9762a9f8ce74c9eed4a4e74306f2f18613a6b71fa065495a67ac227b3056"}, - {file = "lxml-5.4.0-cp311-cp311-musllinux_1_2_ppc64le.whl", hash = "sha256:f5cb182f6396706dc6cc1896dd02b1c889d644c081b0cdec38747573db88a7d7"}, - {file = "lxml-5.4.0-cp311-cp311-musllinux_1_2_s390x.whl", hash = "sha256:3a3178b4873df8ef9457a4875703488eb1622632a9cee6d76464b60e90adbfcd"}, - {file = "lxml-5.4.0-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:e094ec83694b59d263802ed03a8384594fcce477ce484b0cbcd0008a211ca751"}, - {file = "lxml-5.4.0-cp311-cp311-win32.whl", hash = "sha256:4329422de653cdb2b72afa39b0aa04252fca9071550044904b2e7036d9d97fe4"}, - {file = "lxml-5.4.0-cp311-cp311-win_amd64.whl", hash = "sha256:fd3be6481ef54b8cfd0e1e953323b7aa9d9789b94842d0e5b142ef4bb7999539"}, - {file = "lxml-5.4.0-cp312-cp312-macosx_10_9_universal2.whl", hash = "sha256:b5aff6f3e818e6bdbbb38e5967520f174b18f539c2b9de867b1e7fde6f8d95a4"}, - {file = "lxml-5.4.0-cp312-cp312-macosx_10_9_x86_64.whl", hash = "sha256:942a5d73f739ad7c452bf739a62a0f83e2578afd6b8e5406308731f4ce78b16d"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:460508a4b07364d6abf53acaa0a90b6d370fafde5693ef37602566613a9b0779"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:529024ab3a505fed78fe3cc5ddc079464e709f6c892733e3f5842007cec8ac6e"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:7ca56ebc2c474e8f3d5761debfd9283b8b18c76c4fc0967b74aeafba1f5647f9"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:a81e1196f0a5b4167a8dafe3a66aa67c4addac1b22dc47947abd5d5c7a3f24b5"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:00b8686694423ddae324cf614e1b9659c2edb754de617703c3d29ff568448df5"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_28_aarch64.whl", hash = "sha256:c5681160758d3f6ac5b4fea370495c48aac0989d6a0f01bb9a72ad8ef5ab75c4"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_28_ppc64le.whl", hash = "sha256:2dc191e60425ad70e75a68c9fd90ab284df64d9cd410ba8d2b641c0c45bc006e"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_28_s390x.whl", hash = "sha256:67f779374c6b9753ae0a0195a892a1c234ce8416e4448fe1e9f34746482070a7"}, - {file = "lxml-5.4.0-cp312-cp312-manylinux_2_28_x86_64.whl", hash = "sha256:79d5bfa9c1b455336f52343130b2067164040604e41f6dc4d8313867ed540079"}, - {file = "lxml-5.4.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3d3c30ba1c9b48c68489dc1829a6eede9873f52edca1dda900066542528d6b20"}, - {file = "lxml-5.4.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:1af80c6316ae68aded77e91cd9d80648f7dd40406cef73df841aa3c36f6907c8"}, - {file = "lxml-5.4.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:4d885698f5019abe0de3d352caf9466d5de2baded00a06ef3f1216c1a58ae78f"}, - {file = "lxml-5.4.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:aea53d51859b6c64e7c51d522c03cc2c48b9b5d6172126854cc7f01aa11f52bc"}, - {file = "lxml-5.4.0-cp312-cp312-win32.whl", hash = "sha256:d90b729fd2732df28130c064aac9bb8aff14ba20baa4aee7bd0795ff1187545f"}, - {file = "lxml-5.4.0-cp312-cp312-win_amd64.whl", hash = "sha256:1dc4ca99e89c335a7ed47d38964abcb36c5910790f9bd106f2a8fa2ee0b909d2"}, - {file = "lxml-5.4.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:773e27b62920199c6197130632c18fb7ead3257fce1ffb7d286912e56ddb79e0"}, - {file = "lxml-5.4.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:ce9c671845de9699904b1e9df95acfe8dfc183f2310f163cdaa91a3535af95de"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:9454b8d8200ec99a224df8854786262b1bd6461f4280064c807303c642c05e76"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:cccd007d5c95279e529c146d095f1d39ac05139de26c098166c4beb9374b0f4d"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:0fce1294a0497edb034cb416ad3e77ecc89b313cff7adbee5334e4dc0d11f422"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:24974f774f3a78ac12b95e3a20ef0931795ff04dbb16db81a90c37f589819551"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:497cab4d8254c2a90bf988f162ace2ddbfdd806fce3bda3f581b9d24c852e03c"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_28_aarch64.whl", hash = "sha256:e794f698ae4c5084414efea0f5cc9f4ac562ec02d66e1484ff822ef97c2cadff"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_28_ppc64le.whl", hash = "sha256:2c62891b1ea3094bb12097822b3d44b93fc6c325f2043c4d2736a8ff09e65f60"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_28_s390x.whl", hash = "sha256:142accb3e4d1edae4b392bd165a9abdee8a3c432a2cca193df995bc3886249c8"}, - {file = "lxml-5.4.0-cp313-cp313-manylinux_2_28_x86_64.whl", hash = "sha256:1a42b3a19346e5601d1b8296ff6ef3d76038058f311902edd574461e9c036982"}, - {file = "lxml-5.4.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4291d3c409a17febf817259cb37bc62cb7eb398bcc95c1356947e2871911ae61"}, - {file = "lxml-5.4.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:4f5322cf38fe0e21c2d73901abf68e6329dc02a4994e483adbcf92b568a09a54"}, - {file = "lxml-5.4.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:0be91891bdb06ebe65122aa6bf3fc94489960cf7e03033c6f83a90863b23c58b"}, - {file = "lxml-5.4.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:15a665ad90054a3d4f397bc40f73948d48e36e4c09f9bcffc7d90c87410e478a"}, - {file = "lxml-5.4.0-cp313-cp313-win32.whl", hash = "sha256:d5663bc1b471c79f5c833cffbc9b87d7bf13f87e055a5c86c363ccd2348d7e82"}, - {file = "lxml-5.4.0-cp313-cp313-win_amd64.whl", hash = "sha256:bcb7a1096b4b6b24ce1ac24d4942ad98f983cd3810f9711bcd0293f43a9d8b9f"}, - {file = "lxml-5.4.0-cp36-cp36m-macosx_10_9_x86_64.whl", hash = "sha256:7be701c24e7f843e6788353c055d806e8bd8466b52907bafe5d13ec6a6dbaecd"}, - {file = "lxml-5.4.0-cp36-cp36m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:fb54f7c6bafaa808f27166569b1511fc42701a7713858dddc08afdde9746849e"}, - {file = "lxml-5.4.0-cp36-cp36m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:97dac543661e84a284502e0cf8a67b5c711b0ad5fb661d1bd505c02f8cf716d7"}, - {file = "lxml-5.4.0-cp36-cp36m-manylinux_2_28_x86_64.whl", hash = "sha256:c70e93fba207106cb16bf852e421c37bbded92acd5964390aad07cb50d60f5cf"}, - {file = "lxml-5.4.0-cp36-cp36m-manylinux_2_5_x86_64.manylinux1_x86_64.whl", hash = "sha256:9c886b481aefdf818ad44846145f6eaf373a20d200b5ce1a5c8e1bc2d8745410"}, - {file = "lxml-5.4.0-cp36-cp36m-musllinux_1_2_x86_64.whl", hash = "sha256:fa0e294046de09acd6146be0ed6727d1f42ded4ce3ea1e9a19c11b6774eea27c"}, - {file = "lxml-5.4.0-cp36-cp36m-win32.whl", hash = "sha256:61c7bbf432f09ee44b1ccaa24896d21075e533cd01477966a5ff5a71d88b2f56"}, - {file = "lxml-5.4.0-cp36-cp36m-win_amd64.whl", hash = "sha256:7ce1a171ec325192c6a636b64c94418e71a1964f56d002cc28122fceff0b6121"}, - {file = "lxml-5.4.0-cp37-cp37m-macosx_10_9_x86_64.whl", hash = "sha256:795f61bcaf8770e1b37eec24edf9771b307df3af74d1d6f27d812e15a9ff3872"}, - {file = "lxml-5.4.0-cp37-cp37m-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:29f451a4b614a7b5b6c2e043d7b64a15bd8304d7e767055e8ab68387a8cacf4e"}, - {file = "lxml-5.4.0-cp37-cp37m-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:891f7f991a68d20c75cb13c5c9142b2a3f9eb161f1f12a9489c82172d1f133c0"}, - {file = "lxml-5.4.0-cp37-cp37m-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4aa412a82e460571fad592d0f93ce9935a20090029ba08eca05c614f99b0cc92"}, - {file = "lxml-5.4.0-cp37-cp37m-manylinux_2_28_aarch64.whl", hash = "sha256:ac7ba71f9561cd7d7b55e1ea5511543c0282e2b6450f122672a2694621d63b7e"}, - {file = "lxml-5.4.0-cp37-cp37m-manylinux_2_28_x86_64.whl", hash = "sha256:c5d32f5284012deaccd37da1e2cd42f081feaa76981f0eaa474351b68df813c5"}, - {file = "lxml-5.4.0-cp37-cp37m-musllinux_1_2_aarch64.whl", hash = "sha256:ce31158630a6ac85bddd6b830cffd46085ff90498b397bd0a259f59d27a12188"}, - {file = "lxml-5.4.0-cp37-cp37m-musllinux_1_2_x86_64.whl", hash = "sha256:31e63621e073e04697c1b2d23fcb89991790eef370ec37ce4d5d469f40924ed6"}, - {file = "lxml-5.4.0-cp37-cp37m-win32.whl", hash = "sha256:be2ba4c3c5b7900246a8f866580700ef0d538f2ca32535e991027bdaba944063"}, - {file = "lxml-5.4.0-cp37-cp37m-win_amd64.whl", hash = "sha256:09846782b1ef650b321484ad429217f5154da4d6e786636c38e434fa32e94e49"}, - {file = "lxml-5.4.0-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:eaf24066ad0b30917186420d51e2e3edf4b0e2ea68d8cd885b14dc8afdcf6556"}, - {file = "lxml-5.4.0-cp38-cp38-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:2b31a3a77501d86d8ade128abb01082724c0dfd9524f542f2f07d693c9f1175f"}, - {file = "lxml-5.4.0-cp38-cp38-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0e108352e203c7afd0eb91d782582f00a0b16a948d204d4dec8565024fafeea5"}, - {file = "lxml-5.4.0-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:a11a96c3b3f7551c8a8109aa65e8594e551d5a84c76bf950da33d0fb6dfafab7"}, - {file = "lxml-5.4.0-cp38-cp38-manylinux_2_28_aarch64.whl", hash = "sha256:ca755eebf0d9e62d6cb013f1261e510317a41bf4650f22963474a663fdfe02aa"}, - {file = "lxml-5.4.0-cp38-cp38-manylinux_2_28_x86_64.whl", hash = "sha256:4cd915c0fb1bed47b5e6d6edd424ac25856252f09120e3e8ba5154b6b921860e"}, - {file = "lxml-5.4.0-cp38-cp38-musllinux_1_2_aarch64.whl", hash = "sha256:226046e386556a45ebc787871d6d2467b32c37ce76c2680f5c608e25823ffc84"}, - {file = "lxml-5.4.0-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:b108134b9667bcd71236c5a02aad5ddd073e372fb5d48ea74853e009fe38acb6"}, - {file = "lxml-5.4.0-cp38-cp38-win32.whl", hash = "sha256:1320091caa89805df7dcb9e908add28166113dcd062590668514dbd510798c88"}, - {file = "lxml-5.4.0-cp38-cp38-win_amd64.whl", hash = "sha256:073eb6dcdf1f587d9b88c8c93528b57eccda40209cf9be549d469b942b41d70b"}, - {file = "lxml-5.4.0-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:bda3ea44c39eb74e2488297bb39d47186ed01342f0022c8ff407c250ac3f498e"}, - {file = "lxml-5.4.0-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:9ceaf423b50ecfc23ca00b7f50b64baba85fb3fb91c53e2c9d00bc86150c7e40"}, - {file = "lxml-5.4.0-cp39-cp39-manylinux_2_12_i686.manylinux2010_i686.manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:664cdc733bc87449fe781dbb1f309090966c11cc0c0cd7b84af956a02a8a4729"}, - {file = "lxml-5.4.0-cp39-cp39-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:67ed8a40665b84d161bae3181aa2763beea3747f748bca5874b4af4d75998f87"}, - {file = "lxml-5.4.0-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:9b4a3bd174cc9cdaa1afbc4620c049038b441d6ba07629d89a83b408e54c35cd"}, - {file = "lxml-5.4.0-cp39-cp39-manylinux_2_28_aarch64.whl", hash = "sha256:b0989737a3ba6cf2a16efb857fb0dfa20bc5c542737fddb6d893fde48be45433"}, - {file = "lxml-5.4.0-cp39-cp39-manylinux_2_28_x86_64.whl", hash = "sha256:dc0af80267edc68adf85f2a5d9be1cdf062f973db6790c1d065e45025fa26140"}, - {file = "lxml-5.4.0-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:639978bccb04c42677db43c79bdaa23785dc7f9b83bfd87570da8207872f1ce5"}, - {file = "lxml-5.4.0-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:5a99d86351f9c15e4a901fc56404b485b1462039db59288b203f8c629260a142"}, - {file = "lxml-5.4.0-cp39-cp39-win32.whl", hash = "sha256:3e6d5557989cdc3ebb5302bbdc42b439733a841891762ded9514e74f60319ad6"}, - {file = "lxml-5.4.0-cp39-cp39-win_amd64.whl", hash = "sha256:a8c9b7f16b63e65bbba889acb436a1034a82d34fa09752d754f88d708eca80e1"}, - {file = "lxml-5.4.0-pp310-pypy310_pp73-macosx_10_15_x86_64.whl", hash = "sha256:1b717b00a71b901b4667226bba282dd462c42ccf618ade12f9ba3674e1fabc55"}, - {file = "lxml-5.4.0-pp310-pypy310_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:27a9ded0f0b52098ff89dd4c418325b987feed2ea5cc86e8860b0f844285d740"}, - {file = "lxml-5.4.0-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:4b7ce10634113651d6f383aa712a194179dcd496bd8c41e191cec2099fa09de5"}, - {file = "lxml-5.4.0-pp310-pypy310_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:53370c26500d22b45182f98847243efb518d268374a9570409d2e2276232fd37"}, - {file = "lxml-5.4.0-pp310-pypy310_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:c6364038c519dffdbe07e3cf42e6a7f8b90c275d4d1617a69bb59734c1a2d571"}, - {file = "lxml-5.4.0-pp310-pypy310_pp73-win_amd64.whl", hash = "sha256:b12cb6527599808ada9eb2cd6e0e7d3d8f13fe7bbb01c6311255a15ded4c7ab4"}, - {file = "lxml-5.4.0-pp37-pypy37_pp73-macosx_10_9_x86_64.whl", hash = "sha256:5f11a1526ebd0dee85e7b1e39e39a0cc0d9d03fb527f56d8457f6df48a10dc0c"}, - {file = "lxml-5.4.0-pp37-pypy37_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:48b4afaf38bf79109bb060d9016fad014a9a48fb244e11b94f74ae366a64d252"}, - {file = "lxml-5.4.0-pp37-pypy37_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:de6f6bb8a7840c7bf216fb83eec4e2f79f7325eca8858167b68708b929ab2172"}, - {file = "lxml-5.4.0-pp37-pypy37_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:5cca36a194a4eb4e2ed6be36923d3cffd03dcdf477515dea687185506583d4c9"}, - {file = "lxml-5.4.0-pp37-pypy37_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:b7c86884ad23d61b025989d99bfdd92a7351de956e01c61307cb87035960bcb1"}, - {file = "lxml-5.4.0-pp37-pypy37_pp73-win_amd64.whl", hash = "sha256:53d9469ab5460402c19553b56c3648746774ecd0681b1b27ea74d5d8a3ef5590"}, - {file = "lxml-5.4.0-pp38-pypy38_pp73-macosx_10_9_x86_64.whl", hash = "sha256:56dbdbab0551532bb26c19c914848d7251d73edb507c3079d6805fa8bba5b706"}, - {file = "lxml-5.4.0-pp38-pypy38_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:14479c2ad1cb08b62bb941ba8e0e05938524ee3c3114644df905d2331c76cd57"}, - {file = "lxml-5.4.0-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:32697d2ea994e0db19c1df9e40275ffe84973e4232b5c274f47e7c1ec9763cdd"}, - {file = "lxml-5.4.0-pp38-pypy38_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:24f6df5f24fc3385f622c0c9d63fe34604893bc1a5bdbb2dbf5870f85f9a404a"}, - {file = "lxml-5.4.0-pp38-pypy38_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:151d6c40bc9db11e960619d2bf2ec5829f0aaffb10b41dcf6ad2ce0f3c0b2325"}, - {file = "lxml-5.4.0-pp38-pypy38_pp73-win_amd64.whl", hash = "sha256:4025bf2884ac4370a3243c5aa8d66d3cb9e15d3ddd0af2d796eccc5f0244390e"}, - {file = "lxml-5.4.0-pp39-pypy39_pp73-macosx_10_15_x86_64.whl", hash = "sha256:9459e6892f59ecea2e2584ee1058f5d8f629446eab52ba2305ae13a32a059530"}, - {file = "lxml-5.4.0-pp39-pypy39_pp73-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:47fb24cc0f052f0576ea382872b3fc7e1f7e3028e53299ea751839418ade92a6"}, - {file = "lxml-5.4.0-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:50441c9de951a153c698b9b99992e806b71c1f36d14b154592580ff4a9d0d877"}, - {file = "lxml-5.4.0-pp39-pypy39_pp73-manylinux_2_28_aarch64.whl", hash = "sha256:ab339536aa798b1e17750733663d272038bf28069761d5be57cb4a9b0137b4f8"}, - {file = "lxml-5.4.0-pp39-pypy39_pp73-manylinux_2_28_x86_64.whl", hash = "sha256:9776af1aad5a4b4a1317242ee2bea51da54b2a7b7b48674be736d463c999f37d"}, - {file = "lxml-5.4.0-pp39-pypy39_pp73-win_amd64.whl", hash = "sha256:63e7968ff83da2eb6fdda967483a7a023aa497d85ad8f05c3ad9b1f2e8c84987"}, - {file = "lxml-5.4.0.tar.gz", hash = "sha256:d12832e1dbea4be280b22fd0ea7c9b87f0d8fc51ba06e92dc62d52f804f78ebd"}, + {file = "lxml-6.1.1-cp310-cp310-macosx_10_9_universal2.whl", hash = "sha256:09dd5b7075dc2f7709654a46543ba1ea3c2e217b2ed8fbd413a8a945a0f40f60"}, + {file = "lxml-6.1.1-cp310-cp310-macosx_10_9_x86_64.whl", hash = "sha256:f6ac4ef4d82dff54670227a69c67782ae0b811b5cf6b17954f1e8f7502fc0d1d"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:556e94a63c9b04716f8e4de2abb65775061f846e89331b6c5be79183a24f98ea"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:5c6bf403fbb3b3e348a561a5f4f0b9961835657981c802a1df03653eef8a9074"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1dde6131244bba38a17c745836ba190bc753fd73c9291666287fd0a3fa3dcf30"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:98fc784c2c1440667aeedf8465bdfe10208acf0ead656a2c68627299f546b315"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux_2_28_i686.whl", hash = "sha256:add8cf6ddf9a65116119a28ece0f7886e30af27ba724a7594305f1d1b58a92a1"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux_2_31_armv7l.whl", hash = "sha256:cf9d57306d848218f3601fee7601fab1a327c942d56e2e97610583cb4dd74206"}, + {file = "lxml-6.1.1-cp310-cp310-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:88136950da4d13c318bde414ce10219931937851327f44328f2df4d2c4614067"}, + {file = "lxml-6.1.1-cp310-cp310-musllinux_1_2_aarch64.whl", hash = "sha256:cecdd5dfdc87b1fd87dbf81d4b037a544f47f4c744200a67013771682d67686a"}, + {file = "lxml-6.1.1-cp310-cp310-musllinux_1_2_armv7l.whl", hash = "sha256:cd312b9692e831d2ffcad61eab31d91d4b4655a962e61de8fb410472cbcd37aa"}, + {file = "lxml-6.1.1-cp310-cp310-musllinux_1_2_riscv64.whl", hash = "sha256:5b7328b46d49fc9477d91ae8f6d55340347d827b7734ba3ea33faae0efef1383"}, + {file = "lxml-6.1.1-cp310-cp310-musllinux_1_2_x86_64.whl", hash = "sha256:37a58976370f36d9329d118ad0b953c5aeb9119ac9c6a4e258942a225d0573a1"}, + {file = "lxml-6.1.1-cp310-cp310-win32.whl", hash = "sha256:cea3f4c1af79af13cdb2da0c028111d8f8522d4f22a000c82385535f24e5cf3a"}, + {file = "lxml-6.1.1-cp310-cp310-win_amd64.whl", hash = "sha256:3abf332af33a74288675d936fe861fd4344da0dd6622193fbc4f2bfbb35536b5"}, + {file = "lxml-6.1.1-cp310-cp310-win_arm64.whl", hash = "sha256:8dadbe5b217ff35b6a8d16610dd710219b59b76d13f0e3f0d9f36786206e4485"}, + {file = "lxml-6.1.1-cp311-cp311-macosx_10_9_universal2.whl", hash = "sha256:53b7d2b7a10b1c35c0a5e21e9224accf60c1bbfba523990732e521b2b73adef2"}, + {file = "lxml-6.1.1-cp311-cp311-macosx_10_9_x86_64.whl", hash = "sha256:ff3f333630ab480244a1bff72043e511a91eb22e7595dead8653ee5612dd8f3d"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:a4bbea04c97f6d78a48e3fbc1cb9116d2780b1b39e03a23f6eb9b603fd61f510"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:db1d75f6617a49c1c01bc7023713e0ff59ab32c9579ae62a7674c0e34f3b0b0a"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:3a12689be69a28ddaa0ab99a5a1137da2afd5f8f16df7b5680b66f616d3eda1d"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:18b73c339ae29b90fd2d06e58ebd555a751bde9cd6bbd36cc0281b9a2c94e9d8"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux_2_28_i686.whl", hash = "sha256:752d3bbfe874715ccd0aec7f88d7fc623c0f1fd7aa7b3238a084e017bad2a009"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux_2_31_armv7l.whl", hash = "sha256:6b1761fbf9ec984e2e9d9c589ef5f5fd684b7c19f92aadd567a26c5224958db6"}, + {file = "lxml-6.1.1-cp311-cp311-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d680fbcb768404c601ecb43519ecd8461f6954cb11c06a78962f666832ccfca8"}, + {file = "lxml-6.1.1-cp311-cp311-musllinux_1_2_aarch64.whl", hash = "sha256:162af1091cd785f2f27e62d3547ae9bc58ec5c86dd314d67021fd02463708d83"}, + {file = "lxml-6.1.1-cp311-cp311-musllinux_1_2_armv7l.whl", hash = "sha256:e9308ff8241c532df3f3e570f9a5aeed6c853f888512ba4b75638d7c11c95ef6"}, + {file = "lxml-6.1.1-cp311-cp311-musllinux_1_2_riscv64.whl", hash = "sha256:5f6994074ebae6ffb04447268e37dc16edc304f9859cf91acb86e0af6c1b395c"}, + {file = "lxml-6.1.1-cp311-cp311-musllinux_1_2_x86_64.whl", hash = "sha256:80c2dfadb855da477cf73373ad29a333535dedb9b12bad02c9814c8e2b43bf08"}, + {file = "lxml-6.1.1-cp311-cp311-win32.whl", hash = "sha256:30a89d3ac8faec007453fb541f3f46807eeec88edd5826f6e3fe001752a2c621"}, + {file = "lxml-6.1.1-cp311-cp311-win_amd64.whl", hash = "sha256:abbefa31eee84842140f67acef1c828e28bba8bbf0c3bc6e5492a9af88152c28"}, + {file = "lxml-6.1.1-cp311-cp311-win_arm64.whl", hash = "sha256:dcb292aa7fe485ceff7af4f92e46c5af397daec5dff64871a528f0fc47a3cc5b"}, + {file = "lxml-6.1.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:104c09bda8d2a562824c0e319d0768ce26a779b7601e0931d33b09b53c392ef7"}, + {file = "lxml-6.1.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:25c6997a9a534e016695a0ba06b2f07945de682731ff01065b6d5a4474179da1"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:c921ba5c51e4e9f63b8b00267d06566e1f63407408a0496da2d1d0bfc819c7fc"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:54a7f95e4de5fb94e2f9f4b9055c6ba33bf3d628fd77a1d647c5923caa2cdcdc"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96f2ec43df44b1f76249ee0a615334f9b5b060e1c8bd90e706dad2d14d02f383"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:70ef8a7e102a1508f8121aae5b0867abd663f72c14f0a9c937e6554cb4587b7b"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ebe6af670449830d6d9b752c256a983291c766a1365ba5d5460048f9e33a7818"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux_2_28_i686.whl", hash = "sha256:27acc820660aaffa4f7c087f29120e12980f7779d56d8492d263170111284740"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux_2_31_armv7l.whl", hash = "sha256:1db753c9115ec7100d073b744d17e25e88a8f90f5c39b2f5dd878149af59671f"}, + {file = "lxml-6.1.1-cp312-cp312-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:c4f469aebd783bb741c2ecb2a681008fd26bfe5c16a9a72ed5467f834e810df2"}, + {file = "lxml-6.1.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:766b010012d59470072c1816b5b6c69f1d243e5db36ea5968e94accf430a4635"}, + {file = "lxml-6.1.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:b8d812c6011c08b8111a15e54dd990b8923692d80adf35488bee34026c35accf"}, + {file = "lxml-6.1.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:fe0306bd29505a9177aac19f1877174b0e7422c222a59f70b2cd41633448c3dc"}, + {file = "lxml-6.1.1-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:5ba186ad207446c65d3bb3d3e0412b032b1d9f595e59861e2354798c5703d955"}, + {file = "lxml-6.1.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:aa366a1e55b8ebfe8ca8ddc3cfe75c8ebade181aeb0f661d0cb05986b647f72a"}, + {file = "lxml-6.1.1-cp312-cp312-win32.whl", hash = "sha256:126c93f7f56f0eda92f6d8c619edc463a4f23d9252f1c9d0405a76f25fa9f11a"}, + {file = "lxml-6.1.1-cp312-cp312-win_amd64.whl", hash = "sha256:26e6eda8d38c1fcab1090dd196ee87cbd13788e531937610e2589085de074e77"}, + {file = "lxml-6.1.1-cp312-cp312-win_arm64.whl", hash = "sha256:6540377fbd53fe1b629172288c464fb18db11ce1fa7dc15891da10aa9dcc3e7f"}, + {file = "lxml-6.1.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:68a9198d0fc122d14bb76837de9aa80cf84caed990b5b237f532ed87d3706736"}, + {file = "lxml-6.1.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:7d47866cb32fb503450b6edc9df355d10dc49836af2e89901bd6ac6b0896d9d9"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:eb7c9811bfaa8b1ed5ed319f5d370dfbcaa59d52ea64be2a5a85e18195930354"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:762ff394d5bd56da0cf034a23dcce4e13923f15321a2adfa2ac00201dc6d3fca"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:a088f287f7d8275a33c07f2cac6c50b9319309a0200a39e7e75d80c707723099"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:e902da4b04e6b52e5893900d4b8ab46068f75f3561f01bf1080957f9fd932ed6"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:1d4962d4c66bf830a7e59ed6cfc17d148149898a3aefa8ec6e59763e6e3ed085"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux_2_28_i686.whl", hash = "sha256:581d4c8ae690a6609e64862dd6b7c2489635c2d13907fc2b20f2bc200ff1d21e"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux_2_31_armv7l.whl", hash = "sha256:876e1ff5930ed8bf295ec5ef9a8155e9b6b1876bbf1deed8b3a8069311875a8f"}, + {file = "lxml-6.1.1-cp313-cp313-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:9eb9b5a968f6e0f6d640092a567e14529ff8cea2e29d00da6f78a79fa49f013c"}, + {file = "lxml-6.1.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:aa49e06d94aba782c6a02eecb7e507969e7e7a41b267f1b359bb35585f295d5b"}, + {file = "lxml-6.1.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:70cdfd80589d59e43e18005dd7244e8895e93db8ab6a620b7e23df5445a4e3d2"}, + {file = "lxml-6.1.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:aad9aa39483ed8ec44d6d2e59e5b98a0d80676ef0d92f44bfc374836111f62f5"}, + {file = "lxml-6.1.1-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:d49514be2f28d895c38cf9d2b72d7b9a07d00314519f456c0b50b53cfcf4c785"}, + {file = "lxml-6.1.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:47402e62c52ff5988c1e8c6c63177f5708bccf48e366dea4e3dcf1e645e04947"}, + {file = "lxml-6.1.1-cp313-cp313-win32.whl", hash = "sha256:3483644525531e1d5762b0c44a8e18b6efba321b6dcf8a8952de10b037618bca"}, + {file = "lxml-6.1.1-cp313-cp313-win_amd64.whl", hash = "sha256:a10bd2fd62e8ce916ececb342f348f190724a098c1faa056fdfb2a22ad5e8660"}, + {file = "lxml-6.1.1-cp313-cp313-win_arm64.whl", hash = "sha256:424aa57aca0897eb922aef34395bd1289b3b6f04e6bae20ea123c0c7e333cffc"}, + {file = "lxml-6.1.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:19b7ab10b210b0b3ad7985d9ac4eb66ab09a90b20fe6e2f7ba55d01a234345d0"}, + {file = "lxml-6.1.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:c08e5c694306507275f2290073350c4f32e383db15213b2c69e7ff39c1193840"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:74a9717fd0d82effef5c2854f0d917231d5324b5a3eb7275c43ac9fa32f97a14"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:efe0374196335f93b53269acd811b944f2e6bdc88e8894f214bd636455484909"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ac931cdc9442c1763b8a8f6cd62c0c938737eafc5be75eff88df55fc73bc0d00"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:aee395f5d0927f947758b4ec119fd5fc8ec71f07a1c5c52077b30b04c0fa6955"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9395002973c827b3ed67db77e6ec09f092919a587022174554096a269378fb13"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux_2_28_i686.whl", hash = "sha256:73bc2086f141224ebddb7fc5c6a36ca58b31b94b561e1dfe8e073e3270fad1e7"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux_2_31_armv7l.whl", hash = "sha256:3779def59032b81e44a5f70096ef6bf2082f8d901937dca354474ba09782e245"}, + {file = "lxml-6.1.1-cp314-cp314-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:86c89b9d55ebf820ad7c90bc533410f0d098054f293351f10603c0c46ff598f5"}, + {file = "lxml-6.1.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19607c6bbff2a44cf3fe8250abccd20942d3462473e0a721d01d379ed017e462"}, + {file = "lxml-6.1.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:c6ed5141a5c7507cf3ee76bd363b0d6f801e3321adc35b5d825a23115faa5465"}, + {file = "lxml-6.1.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:62aeb7e85b5d60320b9d77eef2e773994e2c0ce10121b277e0a19804e1654a5a"}, + {file = "lxml-6.1.1-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:b1b963fd8f5caa68e99dfae060d54de1fe9cba899b8718b44a00cdca53c3e590"}, + {file = "lxml-6.1.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:63876be28efefa04a1df615b46770e82042cce445cfdce55160522f57b231ccb"}, + {file = "lxml-6.1.1-cp314-cp314-win32.whl", hash = "sha256:7f7a92e8583f06b1fd49d01158143b8461cfcd135dcb10ec807270a3051bd603"}, + {file = "lxml-6.1.1-cp314-cp314-win_amd64.whl", hash = "sha256:b2d444f2e66624d68e9c6b211e28a76e22fff5fcabcfff4deac18b529b7d4137"}, + {file = "lxml-6.1.1-cp314-cp314-win_arm64.whl", hash = "sha256:3fd9728a2735fda14f4e8235830c86b539e9661e849665bf926d3f867943b4bf"}, + {file = "lxml-6.1.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:787b2496d0dbe8cd180984e8d29e3a6f76e7ea34db781cb3bd55e4ba1ef8b4ee"}, + {file = "lxml-6.1.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:2c8daa471358dc2d6fcf02165e80ec68f77871a286df95bc5cc3816153b0fd2c"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:acd7d70b64c0aae0c7922cca83d288a16f5f6da523637697872253415269baef"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:4f0dd2f01f9f8a89f565d000e03abcf0a13d692a346c8d22f628d49af098777a"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:0b7e8a14c8634bf6f7a568634cb395305a6d964aeb5b7ee32248094bed3a7e2c"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux_2_26_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:86281fbdd6a8162756f8d603f37e3435bfa38043adb79c6dc6a2dfee065e7525"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c5d7152ec39ca7c402d8fb9bad86140a15b9503bd0c54484e3f1bbe3dd37ceca"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux_2_28_i686.whl", hash = "sha256:88d8cb75b9d82858497a5393e3c63cfbf03035225e4b35a49ed7ccb151e4dc0e"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux_2_31_armv7l.whl", hash = "sha256:f64ec5397ea6a41fc1b4af0380d79b44a755b5531dcaccd9940fb260dca93038"}, + {file = "lxml-6.1.1-cp314-cp314t-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:d34bbf07dbc7ca5970671b1512e928991fb5e9d95365636c9b2d8b4f53af405e"}, + {file = "lxml-6.1.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:17e0e18d4ad8adbd0399291bc44845b69d9dd68439a3cdebdf35ff902ec05072"}, + {file = "lxml-6.1.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:3ab541146f1f6968c462d6c2ac495148e8cdba2f8347700b2141b6ec5a75bf52"}, + {file = "lxml-6.1.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:2a0217714657e023ef4293500f65aa20fce6164c8fd6b08fa5bd4a859fb14b9b"}, + {file = "lxml-6.1.1-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:05a82eb6e1530a64f26225b55cbd178113bd0b5af1c2b625f25e5296742c26d2"}, + {file = "lxml-6.1.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:9e36f163528fc50cbef305f02a5fd66d404edf7049cdaff211dbc2cba5a7013e"}, + {file = "lxml-6.1.1-cp314-cp314t-win32.whl", hash = "sha256:649dda677cf3bd6ac9ae14007ba0c824ded8ce5808b53fc7431d9140399118c1"}, + {file = "lxml-6.1.1-cp314-cp314t-win_amd64.whl", hash = "sha256:793033d6c5cdf33a573f910d9bea14ef8f5771820411d118da8e1182edb53d5e"}, + {file = "lxml-6.1.1-cp314-cp314t-win_arm64.whl", hash = "sha256:58bb955caba94e467d2a96da17660d2d704e0675894cba21ab8a775b8621fd1c"}, + {file = "lxml-6.1.1-cp38-cp38-macosx_10_9_x86_64.whl", hash = "sha256:6689e828a94eee4f139408c337bb198e014724bb8a8c26d3cfac49d119ed69a6"}, + {file = "lxml-6.1.1-cp38-cp38-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:bdebcc8a75d38c7598dfb2c9ed852d7a9eb4a10d6e2d0764b919b802bf32ac88"}, + {file = "lxml-6.1.1-cp38-cp38-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8be8ad51249698103d24b0571df35a10990fbe93dd043b6c024172189485f5e3"}, + {file = "lxml-6.1.1-cp38-cp38-manylinux_2_28_i686.whl", hash = "sha256:76447f65250ed2501ead1a1552f5ce8edff159a86f308348e6a9c4acb5e1f1b4"}, + {file = "lxml-6.1.1-cp38-cp38-musllinux_1_2_x86_64.whl", hash = "sha256:ffecec8eb889b58ba9be5b95fb1cc78e22ea8eedea38e8736a1568fe1979250e"}, + {file = "lxml-6.1.1-cp38-cp38-win32.whl", hash = "sha256:c674693f055fa2495de12292cb45e9944199d8eaef5a2dec45175c7c61cb73e3"}, + {file = "lxml-6.1.1-cp38-cp38-win_amd64.whl", hash = "sha256:55b03549819867ea141c0202242c4816c82e52ec36e7e648db9d8da5a3dc3ed6"}, + {file = "lxml-6.1.1-cp39-cp39-macosx_10_9_universal2.whl", hash = "sha256:c9f79d5325907f13e1be0b3e4dacc1049d1dffc4aeee3c995284bea5fe0fab7d"}, + {file = "lxml-6.1.1-cp39-cp39-macosx_10_9_x86_64.whl", hash = "sha256:83b6b30eb131da7a75b601f28c5d6971e6ed3e887919bf6b6a1ad3c2df289080"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:441dd227fa0690eb9fc81edabc63cdcefc212bba99b906dcf6e32cc1a9d3e533"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:e07c65f443c887bbcf31cc1771d932ecc192a5273943589b3c7572b749f1ffb2"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:5bec7d03d78d853597d6107854c2310ce3f761fd218fe9fe91d5101fcf6c2efe"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9f76acfb5f68ba982635a53fd985a8044be98a35b43232c2a1ee235ffab3e1dd"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux_2_28_i686.whl", hash = "sha256:8d43ca737b20e106e4aebc42b2f3ae19f00ba63d7eb731698ee083d72d15646f"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux_2_31_armv7l.whl", hash = "sha256:32ab449a5486f6c758e849bb86710d0e45edc24a04e250c01555f8f5653958f8"}, + {file = "lxml-6.1.1-cp39-cp39-manylinux_2_38_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:53c909b62a0532183542fed00c5a7218258c56292d409bc789886fe1cb04c438"}, + {file = "lxml-6.1.1-cp39-cp39-musllinux_1_2_aarch64.whl", hash = "sha256:640f97d43d867bcb9c75b3af013b64850756b746cb6bce8ace83b70da3abba9d"}, + {file = "lxml-6.1.1-cp39-cp39-musllinux_1_2_armv7l.whl", hash = "sha256:469e3618338bd7ab5beb412d2439825479fcf0dab99e394ca563dbc4eaf6c834"}, + {file = "lxml-6.1.1-cp39-cp39-musllinux_1_2_riscv64.whl", hash = "sha256:aae97dfdb60715c164419ac2532a76d013c3918a665eb6cb7288098b5f349aaf"}, + {file = "lxml-6.1.1-cp39-cp39-musllinux_1_2_x86_64.whl", hash = "sha256:c9a4b821dc7055bf9e05ff5719e18ec501f75c0f0bbfabd573b277559780833d"}, + {file = "lxml-6.1.1-cp39-cp39-win32.whl", hash = "sha256:639f6c857d91d9be29bd7502348d6736dab168b54b5158cd899abf11684dc186"}, + {file = "lxml-6.1.1-cp39-cp39-win_amd64.whl", hash = "sha256:34c2d737beabfe35baada43941ed519251e9a12e779031496bcd5d539fcfd730"}, + {file = "lxml-6.1.1-cp39-cp39-win_arm64.whl", hash = "sha256:07a4a68e286ee7a1ed7dfb8af83e615757c0ccfe9f18c6b4ea6771388d9ba8c9"}, + {file = "lxml-6.1.1-pp311-pypy311_pp73-macosx_10_15_x86_64.whl", hash = "sha256:31033dc34636ea6b7d5cc11b1ddbda78a14de858ba9d3e1ed4b69a3085bc521e"}, + {file = "lxml-6.1.1-pp311-pypy311_pp73-manylinux2014_aarch64.manylinux_2_17_aarch64.whl", hash = "sha256:3893c14c4b6ac5b2d54ba8cf03e99fe5104e592de491f19bd6b82756c09f8004"}, + {file = "lxml-6.1.1-pp311-pypy311_pp73-manylinux2014_x86_64.manylinux_2_17_x86_64.whl", hash = "sha256:c07da4cebf6889f03ebac8d238f62318e29f495de0aa18a51ea14e61ae907e2e"}, + {file = "lxml-6.1.1-pp311-pypy311_pp73-manylinux_2_26_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f6f0ce10945fab9c4c06ce14e22af9059d1a87493a9af4501a5b0b9187e21cf2"}, + {file = "lxml-6.1.1-pp311-pypy311_pp73-manylinux_2_26_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f8844cd288697c6425c9beba919302241e3278871dc6519515e72b04e987abcf"}, + {file = "lxml-6.1.1-pp311-pypy311_pp73-win_amd64.whl", hash = "sha256:ed21202aec73cda4d55d1ce57b389aadb90ffb044e6cd1080b8347efe1b1ec84"}, + {file = "lxml-6.1.1.tar.gz", hash = "sha256:ba96ae44888e0185281e937633a743ea90d5a196c6000f82565ebb0580012d40"}, ] [package.extras] @@ -854,7 +856,6 @@ cssselect = ["cssselect (>=0.7)"] html-clean = ["lxml_html_clean"] html5 = ["html5lib"] htmlsoup = ["BeautifulSoup4"] -source = ["Cython (>=3.0.11,<3.1.0)"] [[package]] name = "markupsafe" @@ -993,35 +994,35 @@ files = [ [[package]] name = "openapi-core" -version = "0.19.5" +version = "0.20.0" description = "client-side and server-side support for the OpenAPI Specification v3" optional = false -python-versions = "<4.0.0,>=3.8.0" +python-versions = "<4.0.0,>=3.9.0" groups = ["main"] files = [ - {file = "openapi_core-0.19.5-py3-none-any.whl", hash = "sha256:ef7210e83a59394f46ce282639d8d26ad6fc8094aa904c9c16eb1bac8908911f"}, - {file = "openapi_core-0.19.5.tar.gz", hash = "sha256:421e753da56c391704454e66afe4803a290108590ac8fa6f4a4487f4ec11f2d3"}, + {file = "openapi_core-0.20.0-py3-none-any.whl", hash = "sha256:dffb9b565d35f5265f08daa7cb8ae0d34441738aaea29dc768f663900b925b0e"}, + {file = "openapi_core-0.20.0.tar.gz", hash = "sha256:3de7fcc635139875da0e2102b7de96f1b42738365a2f99d7eef6e835839cc649"}, ] [package.dependencies] isodate = "*" -jsonschema = ">=4.18.0,<5.0.0" -jsonschema-path = ">=0.3.1,<0.4.0" +jsonschema = ">=4.23.0,<5.0.0" +jsonschema-path = ">=0.3.4,<0.4.0" more-itertools = "*" openapi-schema-validator = ">=0.6.0,<0.7.0" openapi-spec-validator = ">=0.7.1,<0.8.0" parse = "*" typing-extensions = ">=4.8.0,<5.0.0" -werkzeug = "<3.1.2" +werkzeug = ">=2.1.0" [package.extras] aiohttp = ["aiohttp (>=3.0)", "multidict (>=6.0.4,<7.0.0)"] django = ["django (>=3.0)"] falcon = ["falcon (>=3.0)"] -fastapi = ["fastapi (>=0.111,<0.116)"] +fastapi = ["fastapi (>=0.111,<0.125)"] flask = ["flask"] requests = ["requests"] -starlette = ["aioitertools (>=0.11,<0.13)", "starlette (>=0.26.1,<0.45.0)"] +starlette = ["aioitertools (>=0.11,<0.14)", "starlette (>=0.26.1,<0.50.0)"] [[package]] name = "openapi-schema-validator" @@ -1504,20 +1505,20 @@ test = ["coverage", "mypy", "ruff", "wheel"] [[package]] name = "pytest" -version = "8.4.2" +version = "9.0.3" description = "pytest: simple powerful testing with Python" optional = false -python-versions = ">=3.9" +python-versions = ">=3.10" groups = ["main", "dev"] files = [ - {file = "pytest-8.4.2-py3-none-any.whl", hash = "sha256:872f880de3fc3a5bdc88a11b39c9710c3497a547cfa9320bc3c5e62fbf272e79"}, - {file = "pytest-8.4.2.tar.gz", hash = "sha256:86c0d0b93306b961d58d62a4db4879f27fe25513d4b969df351abdddb3c30e01"}, + {file = "pytest-9.0.3-py3-none-any.whl", hash = "sha256:2c5efc453d45394fdd706ade797c0a81091eccd1d6e4bccfcd476e2b8e0ab5d9"}, + {file = "pytest-9.0.3.tar.gz", hash = "sha256:b86ada508af81d19edeb213c681b1d48246c1a91d304c6c81a427674c17eb91c"}, ] [package.dependencies] colorama = {version = ">=0.4", markers = "sys_platform == \"win32\""} -iniconfig = ">=1" -packaging = ">=20" +iniconfig = ">=1.0.1" +packaging = ">=22" pluggy = ">=1.5,<2" pygments = ">=2.7.2" @@ -1563,32 +1564,32 @@ dev = ["build", "tox", "tox-uv"] [[package]] name = "pytest-nhsd-apim" -version = "5.0.15" +version = "6.0.10" description = "Pytest plugin accessing NHSDigital's APIM proxies" optional = false -python-versions = "<4.0,>=3.13" +python-versions = ">=3.10" groups = ["dev"] files = [ - {file = "pytest_nhsd_apim-5.0.15-py3-none-any.whl", hash = "sha256:3f6c74d18b29ac1726675410ee46363c62adb20979ac590ff873020c1d208b72"}, - {file = "pytest_nhsd_apim-5.0.15.tar.gz", hash = "sha256:df7114f5523cbd28d2629cdee02c72a511cbed7a878d673805e597444b265a59"}, + {file = "pytest_nhsd_apim-6.0.10-py3-none-any.whl", hash = "sha256:49364f43906bd1aa403576e69e49f33e97b1c81e24a6e25a61758784d4a55b37"}, + {file = "pytest_nhsd_apim-6.0.10.tar.gz", hash = "sha256:3f2bece8f57ac976109c91d2a2391a77c7791bfa7ee4435e2c08b75005e4f961"}, ] [package.dependencies] -Authlib = ">=1.6.1,<2.0.0" -cryptography = ">44.0.1" -lxml = ">=5.3.1,<6.0.0" +Authlib = ">=1.6.6,<2.0.0" +cryptography = ">=46.0.5" +lxml = ">=5.3.1,<7.0.0" pycryptodome = ">=3.20.0,<4.0.0" pydantic = ">=2.9.2,<3.0.0" pydantic-settings = ">=2.2.1,<3.0.0" PyJWT = ">=2.8.0,<3.0.0" pyotp = ">=2.9.0,<3.0.0" -pytest = ">=8.2.0,<9.0.0" +pytest = ">=8.2.0,<10.0.0" requests = ">=2.32.0,<3.0.0" setuptools = ">=80.0.1,<81.0.0" -toml = ">=0.10.2,<0.11.0" +toml = ">=0.10.2,<1.0.0" typing-extensions = ">=4.12.2,<5.0.0" -urllib3 = ">=2.6.1,<3.0.0" -wheel = ">=0.37.1,<0.45.0" +urllib3 = ">=2.6.3,<3.0.0" +wheel = ">=0.46.2,<0.47.0" [[package]] name = "python-dotenv" @@ -2049,36 +2050,39 @@ files = [ [[package]] name = "werkzeug" -version = "3.1.1" +version = "3.1.8" description = "The comprehensive WSGI web application library." optional = false python-versions = ">=3.9" groups = ["main"] files = [ - {file = "werkzeug-3.1.1-py3-none-any.whl", hash = "sha256:a71124d1ef06008baafa3d266c02f56e1836a5984afd6dd6c9230669d60d9fb5"}, - {file = "werkzeug-3.1.1.tar.gz", hash = "sha256:8cd39dfbdfc1e051965f156163e2974e52c210f130810e9ad36858f0fd3edad4"}, + {file = "werkzeug-3.1.8-py3-none-any.whl", hash = "sha256:63a77fb8892bf28ebc3178683445222aa500e48ebad5ec77b0ad80f8726b1f50"}, + {file = "werkzeug-3.1.8.tar.gz", hash = "sha256:9bad61a4268dac112f1c5cd4630a56ede601b6ed420300677a869083d70a4c44"}, ] [package.dependencies] -MarkupSafe = ">=2.1.1" +markupsafe = ">=2.1.1" [package.extras] watchdog = ["watchdog (>=2.3)"] [[package]] name = "wheel" -version = "0.44.0" -description = "A built-package format for Python" +version = "0.46.3" +description = "Command line tool for manipulating wheel files" optional = false -python-versions = ">=3.8" +python-versions = ">=3.9" groups = ["dev"] files = [ - {file = "wheel-0.44.0-py3-none-any.whl", hash = "sha256:2376a90c98cc337d18623527a97c31797bd02bad0033d41547043a1cbfbe448f"}, - {file = "wheel-0.44.0.tar.gz", hash = "sha256:a29c3f2817e95ab89aa4660681ad547c0e9547f20e75b0562fe7723c9a2a9d49"}, + {file = "wheel-0.46.3-py3-none-any.whl", hash = "sha256:4b399d56c9d9338230118d705d9737a2a468ccca63d5e813e2a4fc7815d8bc4d"}, + {file = "wheel-0.46.3.tar.gz", hash = "sha256:e3e79874b07d776c40bd6033f8ddf76a7dad46a7b8aa1b2787a83083519a1803"}, ] +[package.dependencies] +packaging = ">=24.0" + [package.extras] -test = ["pytest (>=6.0.0)", "setuptools (>=65)"] +test = ["pytest (>=6.0.0)", "setuptools (>=77)"] [[package]] name = "xmlformatter" @@ -2095,4 +2099,4 @@ files = [ [metadata] lock-version = "2.1" python-versions = "^3.13" -content-hash = "4b413ee8c6da27df69efe47f6d76ffc0a84aea31beaff65a49d1a140e84c50c1" +content-hash = "13b9886c282eb75b382827f0b627b0ae7df943b47e5fb9c9794fd24f44ea43d1" diff --git a/pyproject.toml b/pyproject.toml index 587dad0b4..f06756c1c 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -26,11 +26,12 @@ docopt = "^0.6.2" jsonpath-rw = "^1.4.0" semver = "^3.0.4" gitpython = "^3.1.45" -lxml = "^5.1.0" +lxml = "^6.1.0" xmlformatter = "^0.2.8" pytest-check = "^2.6.2" requests = "^2.32.5" -openapi-core = "^0.19.5" +openapi-core = "^0.20.0" +werkzeug = ">=3.1.6" [tool.poetry.group.dev.dependencies] @@ -38,9 +39,9 @@ flake8 = "^7.3.0" black = "^26.3.1" pip-licenses = "^5.5.0" jinja2 = "^3.1.6" -pytest = "^8.4.2" +pytest = "^9.0.3" pytest-asyncio = "^1.3.0" -pytest-nhsd-apim = "^5.0.6" +pytest-nhsd-apim = "^6.0.0" [tool.poetry.scripts] From 31f1b7df1c7d2039946a93bd244edfa7df8c238f Mon Sep 17 00:00:00 2001 From: dbgwilliamsnhs Date: Fri, 22 May 2026 14:48:35 +0000 Subject: [PATCH 52/55] [RAA-7705]-[]-[testdev environment apim support]-[DW] --- azure/azure-release-pipeline.yml | 15 +++++++++++++++ manifest_template.yml | 3 +++ 2 files changed, 18 insertions(+) diff --git a/azure/azure-release-pipeline.yml b/azure/azure-release-pipeline.yml index 59fb4348a..9980e892b 100644 --- a/azure/azure-release-pipeline.yml +++ b/azure/azure-release-pipeline.yml @@ -99,6 +99,21 @@ extends: smoke_tests: true depends_on: - ers_manual_approval_int + - environment: manual-approval + stage_name: ers_manual_approval_testdev + - environment: internal-dev + stage_name: ers_testdev_release + service_name: "${{ variables.service_name }}-testdev" + short_service_name: "${{ variables.short_service_name }}-testdev" + service_base_path: "${{ variables.service_base_path }}-testdev" + jinja_templates: + ERS_TARGET_SERVER: e-referrals-service-api--testdev + post_deploy: + - template: templates/run-tests.yml + parameters: + smoke_tests: true + depends_on: + - ers_manual_approval_testdev - environment: manual-approval stage_name: ers_manual_approval_dep - environment: dev diff --git a/manifest_template.yml b/manifest_template.yml index 24b473d8a..0e29f4b9f 100644 --- a/manifest_template.yml +++ b/manifest_template.yml @@ -35,6 +35,9 @@ APIGEE_ENVIRONMENTS: - name: ftxxii-internal-dev display_name: Internal Development - ft22 euo_allowlist_required: false + - name: testdev-internal-dev + display_name: Internal Development - testdev + euo_allowlist_required: false - name: internal-dev-sandbox variants: From 0a567f036978f54cb2553917d3baab16e6f49398 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 3 Jun 2026 12:50:10 +0000 Subject: [PATCH 53/55] pin GitHub Actions to latest versions with commit SHAs --- .github/workflows/combine-prs.yml | 2 +- .github/workflows/continous-integration-workflow.yaml | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/.github/workflows/combine-prs.yml b/.github/workflows/combine-prs.yml index 1a0923113..183855982 100644 --- a/.github/workflows/combine-prs.yml +++ b/.github/workflows/combine-prs.yml @@ -41,7 +41,7 @@ jobs: # Steps represent a sequence of tasks that will be executed as part of the job steps: - - uses: actions/github-script@v8 + - uses: actions/github-script@ed597411d8f924073f98dfc5c65a23a2325f34cd # v8.0.0 id: create-combined-pr name: Create Combined PR with: diff --git a/.github/workflows/continous-integration-workflow.yaml b/.github/workflows/continous-integration-workflow.yaml index f8235c867..6d6c290cb 100644 --- a/.github/workflows/continous-integration-workflow.yaml +++ b/.github/workflows/continous-integration-workflow.yaml @@ -8,12 +8,12 @@ jobs: runs-on: ubuntu-latest steps: - name: Checkout - uses: actions/checkout@v5 + uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3 with: fetch-depth: 0 # This causes all history to be fetched, which is required for calculate-version to function - name: Install Python 3.13 - uses: actions/setup-python@v6 + uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0 with: python-version: '3.13' @@ -34,7 +34,7 @@ jobs: - name: Create release (master only) id: create-release if: github.ref == 'refs/heads/master' - uses: actions/create-release@v1 + uses: actions/create-release@0cb9c9b65d5d1901c1f53e5e66eaf4afd303e70e # v1.1.4 continue-on-error: true env: GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }} From f8abefca45a1bf883c60fc33926daaa4269f1f07 Mon Sep 17 00:00:00 2001 From: kevinmason-nhs Date: Wed, 3 Jun 2026 17:38:28 +0100 Subject: [PATCH 54/55] 422 response for A042 endpoint --- .../r4/NHSDigital-OperationOutcome-422.json | 21 ++++++++++++++++++ .../endpoints/a042-retrieve-attachment.yaml | 4 +++- .../retrieveAttachment/422Response.yaml | 22 +++++++++++++++++++ 3 files changed, 46 insertions(+), 1 deletion(-) create mode 100755 sandbox/src/mocks/r4/NHSDigital-OperationOutcome-422.json create mode 100644 specification/components/r4/schemas/responses/retrieveAttachment/422Response.yaml diff --git a/sandbox/src/mocks/r4/NHSDigital-OperationOutcome-422.json b/sandbox/src/mocks/r4/NHSDigital-OperationOutcome-422.json new file mode 100755 index 000000000..a7475c324 --- /dev/null +++ b/sandbox/src/mocks/r4/NHSDigital-OperationOutcome-422.json @@ -0,0 +1,21 @@ +{ + "resourceType": "OperationOutcome", + "meta": { + "lastUpdated": "2022-03-01T10:00:00.42Z" + }, + "issue": [ + { + "severity": "error", + "code": "invalid", + "details": { + "coding": [ + { + "system": "https://fhir.nhs.uk/CodeSystem/ers-error-codes", + "code": "PENDING" + } + ] + }, + "diagnostics": "The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again." + } + ] +} diff --git a/specification/components/r4/schemas/endpoints/a042-retrieve-attachment.yaml b/specification/components/r4/schemas/endpoints/a042-retrieve-attachment.yaml index 96200ee7d..a6327b9b6 100644 --- a/specification/components/r4/schemas/endpoints/a042-retrieve-attachment.yaml +++ b/specification/components/r4/schemas/endpoints/a042-retrieve-attachment.yaml @@ -29,7 +29,7 @@ description: | - `SERVICE_PROVIDER_CLINICIAN_ADMIN` ### Attachment availability - To use this endpoint, the attachment must be available for download. Attachments are only available after successful validation and malware scans. A request to retrieve an attachment that is not available for download will result in a 400 error. See the Response HTTP 400 section for further information. + To use this endpoint, the attachment must be available for download. Attachments are only available after successful validation and malware scans. A request to retrieve an attachment that is not available for download will result in a 422 error. See the Response HTTP 422 section for further information. The availability status of an attachment can be retrieved via any endpoint that provides details of an attachment in the success response. Details of the availability statuses that may be returned via these endpoints can be found in the specification for [[HYPERLINK_A005]]. @@ -100,6 +100,8 @@ responses: $ref: '../responses/ForbiddenOrNoLR.yaml' '404': $ref: '../responses/NotFound.yaml' + '422': + $ref: '../responses/retrieveAttachment/422Response.yaml' '429': $ref: '../responses/TooManyRequests.yaml' '500': diff --git a/specification/components/r4/schemas/responses/retrieveAttachment/422Response.yaml b/specification/components/r4/schemas/responses/retrieveAttachment/422Response.yaml new file mode 100644 index 000000000..ac6a82ef5 --- /dev/null +++ b/specification/components/r4/schemas/responses/retrieveAttachment/422Response.yaml @@ -0,0 +1,22 @@ +description: | + Where status code 422 (Unprocessable Entity) is returned then an [NHSDigital-OperationOutcome](https://fhir.nhs.uk/StructureDefinition/NHSDigital-OperationOutcome) will be included in the body, as detailed below. + Check diagnostics property for specific information regarding the error. + + | issue.details.coding.code | issue.code | Coding System | Description | + | ------------------------- | ---------- | ------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | + | PENDING | invalid | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The file is being scanned and cannot be retrieved. Wait at least 5 minutes before checking its availability again. | + | THREATS_FOUND | invalid | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The file has been quarantined after detecting a threat and cannot be retrieved. Contact the organisation that uploaded the file to resolve the issue and get the information you need. Details of who uploaded the file can be retrieved via any endpoint that provides details of an attachment in the success response (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example)| + | VALIDATION_FAILED | invalid | [eRS Error Code](https://fhir.nhs.uk/CodeSystem/ers-error-codes) | The file has failed validation and cannot be retrieved. Contact the organisation that uploaded the file to resolve the issue and get the information you need. Details of who uploaded a file can be retrieved via any endpoint that provides details of an attachment in the success response (via the [[HYPERLINK_A005]] or [[HYPERLINK_A024]] endpoints, for example)
Validation can fail because the:
  • content type of the file is not supported
  • content type of the file does not correlate with the file extension
  • file provided is too large and is not supported by e-RS. Note, this indicates that the file size is larger than the system supports as a whole, not the 5MB limit associated with this endpoint
| +headers: + x-correlation-id: + $ref: '../../headers/response/CorrelationID.yaml' + x-request-id: + $ref: '../../headers/response/RequestID.yaml' + Content-Type: + $ref: '../../headers/response/ContentTypeFhirJson.yaml' +content: + application/fhir+json: + schema: + $ref: '../../NHSDigital-OperationOutcome.yaml' + example: + $ref: '../../../examples/NHSDigital-OperationOutcome-422.json' From 79b24e1105f2dac679b32dfa1a415c9f76d751b4 Mon Sep 17 00:00:00 2001 From: EdwardWills-nhs Date: Wed, 10 Jun 2026 09:45:25 +0000 Subject: [PATCH 55/55] [RAA-5861]-[GC]-[Bumping version to 1.54 +minor]-[EW]