Virtually Healthcare HL7 FHIR R4 Implementation Guide
0.1.0-current - ci-build United Kingdom flag

Virtually Healthcare HL7 FHIR R4 Implementation Guide, published by Virtually Healthcare. This guide is not an authorized publication; it is the continuous build for version 0.1.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/Virtually-Healthcare/HL7-FHIR-Implementation-Guide/ and changes regularly. See the Directory of published versions

CapabilityStatement: NHS England Directory Service Facade

Official URL: https://fhir.virtually.healthcare/CapabilityStatement/NHSEFacade Version: 0.1.0-current
Draft as of 2024-10-08 Computable Name: NHSEnglandFacade

This is a Service Facade to Personal Demographics Service - FHIR API and Organisation Data Service - FHIR API

This facade is related to IHE Patient Demographics Query for Mobile (PDQm) and IHE Mobile Care Services Discovery (mCSD)

Raw OpenAPI-Swagger Definition file | Download

Generated Narrative: CapabilityStatement NHSEFacade

NHS England Service Facade

  • Implementation Guide Version: 0.1.0-current
  • FHIR Version: 4.0.1
  • Supported Formats: application/fhir+xml, application/fhir+json
  • Supported Patch Formats:
  • Published on: 2024-10-08
  • Published by: Virtually Healthcare

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

FHIR RESTful Capabilities

Mode: server

Summary of System-wide Interactions

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRSUCSearches_include_revincludeOperations
Patienthttps://fhir.virtually.healthcare/StructureDefinition/Patient
Additional supported profiles:
  UK Core Patient
yyidentifier, name, family, given, birthdate, gender, death-date, address-postalcode, general-practitioner, email, phone
QuestionnaireResponsehttps://fhir.virtually.healthcare/StructureDefinition/QuestionnaireResponse
Additional supported profiles:
  UK Core Questionnaire Response
yquestionnaire, patient, patient:identifier
RelatedPersonhttps://fhir.virtually.healthcare/StructureDefinition/RelatedPerson
Additional supported profiles:
  UK Core Related Person
ypatient:identifier
Organizationhttps://fhir.virtually.healthcare/StructureDefinition/Organization
Additional supported profiles:
  UK Core Organization
yyidentifier, name, active, address-postalcode, address-city, ods-org-primaryRole, type

Resource Conformance: SHALL Patient

Base System Profile
Patient
Profile Conformance
SHALL
Reference Policy

Supported Profiles

UK Core Patient

Interaction summary
  • Supports read, search-type.

Documentation
GET /Patient?{parameters}

Conformance to this implementation guide SHOULD be tested via FHIR Validation.

Search Examples

Search for Patient's for a patient with a NHS Number of 9876543210

GET /Patient?identifier=https://fhir.nhs.uk/Id/nhs-number|9876543210
Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken

A patients NHS Number e.g. identifier=https://fhir.nhs.uk/Id/nhs-number|9876543210

SHALLnamestring

A patients name

SHALLfamilystring

A patients surname

SHALLgivenstring

A patients first name

SHALLbirthdatedate

A patients date of birth

SHALLgendertoken

A patients gender - administrative

SHALLdeath-datetoken

A patients date of birth

SHALLaddress-postalcodestring

A patients postcode

SHALLgeneral-practitionertoken

A patients general practice

SHALLemailtoken

A patients email address

SHALLphonetoken

A patients phone number

 

Resource Conformance: SHALL QuestionnaireResponse

Base System Profile
QuestionnaireResponse
Profile Conformance
SHALL
Reference Policy

Interaction summary
  • Supports search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLquestionnairereference

The questionnaire the answers are provided for, e.g. questionnaire=https://fhir.virtually.healthcare/Questionnaire/PDSPatientPreferences

SHALLpatientreference

The patient that is the subject of the questionnaire response, e.g. patient=Patient/9449304424

SHALLpatient:identifiertoken

The patient identifier that is the subject of the questionnaire response, e.g. patient:identifier=https://fhir.nhs.uk/Id/nhs-number|9449304424

 

Resource Conformance: SHALL RelatedPerson

Base System Profile
RelatedPerson
Profile Conformance
SHALL
Reference Policy

Supported Profiles

UK Core Related Person

Interaction summary
  • Supports search-type.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLpatient:identifiertoken

The patient identifier this related person is related to, e.g. patient:identifier=https://fhir.nhs.uk/Id/nhs-number|9730906181

 

Resource Conformance: SHALL Organization

Base System Profile
Organization
Profile Conformance
SHALL
Reference Policy

Supported Profiles

UK Core Organization

Interaction summary
  • Supports read, search-type.

Documentation
GET /Organization?{parameters}

Conformance to this implementation guide SHOULD be tested via FHIR Validation.

Search Examples

Search for Organization's for a patient with a ODS Code of RR8

GET /Organization?identifier=https://fhir.nhs.uk/Id/ods-organization-code|RR8
Search Parameters
ConformanceParameterTypeDocumentation
SHALLidentifiertoken

A organisations ODS Code e.g. identifier=https://fhir.nhs.uk/Id/ods-organization-code|RR8

SHALLnamestring

A portion of the organization's name or alias

SHALLactivetoken

Is the Organization record active

SHALLaddress-postalcodestring

A postal code specified in an address

SHALLaddress-citystring

A city specified in an address

SHALLods-org-primaryRoletoken

organisation ods primary role

SHALLtypetoken

A code for the type of organization