API Usage

Resolve (zero or more) Practitioner resources using a business identifier (i.e. SDS User Id).

Request Operation

The [system] field SHALL be populated with a valid practitioner identifier system URL (i.e. https://fhir.nhs.uk/Id/sds-user-id).

The consumer systerm SHALL apply percent encoding when constructing the request URL as indicated in RFC 3986 Section 2.1. The will ensure that downstream servers correctly handle the pipe | character which must be used in the identifier parameter value below.

FHIR Relative Request

GET /Practitioner?identifier=[system]|[value]

FHIR Absolute Request

GET https://[proxy_server]/https://[provider_server]/[fhir_base]/Practitioner?identifier=[system]|[value]

Request Headers

Consumers SHALL include the following additional HTTP request headers:

Payload Request Body

N/A

Error Handling

Provider systems:

• SHALL return an GPConnect-OperationOutcome-1 resource that provides additional detail when one or more request fields are corrupt or a specific business rule/constraint is breached.

For example the:

• Business identifier [system] is not recognised/supported by the Provider system.
• Business identifier fails any structural validation checks (i.e. length and check digits).

Request Response

Response Headers

Provider systems are not expected to add any specific headers beyond that described in the HTTP and FHIR® standards.

Payload Response Body

Provider systems:

• SHALL return a 200 OK HTTP status code on successful execution of the operation.
• SHALL return zero or more matching Practitioner resources in a Bundle of type searchset.
• SHALL return Practitioner resources that conform to the CareConnect-GPC-Practitioner-1 profile.
• SHALL include the URI of the CareConnect-GPC-Practitioner-1 profile StructureDefinition in the Practitioner.meta.profile element of the returned Practitioner resources.
• SHALL include the versionId and fullUrl of the current version of each Practitioner resource.
• SHALL include all relevant business identifier details (i.e. SDS User Id) for each Practitioner resource.

{
	"resourceType": "Bundle",
	"type": "searchset",
	"entry": [{
		"fullUrl": "http://gpconnect.aprovider.nhs.net/GP001/STU3/1/Practitioner/15",
		"resource": {
			"resourceType": "Practitioner",
			"id": "15",
			"meta": {
				"versionId": "636064088099800115",
				"lastUpdated": "2016-08-10T13:47:09.966+01:00",
				"profile": ["https://fhir.nhs.uk/STU3/StructureDefinition/CareConnect-GPC-Practitioner-1"]
			},
			"identifier": [{
				"system": "https://fhir.nhs.uk/Id/sds-user-id",
				"value": "S001"
			}],
			"name": {
				"family": ["Black"],
				"given": ["Sarah"],
				"prefix": ["Mrs"]
			},
			"gender": "female"
		}
	}]
}

Example Code

C#

var client = new FhirClient("http://gpconnect.aprovider.nhs.net/GP001/STU3/1/");
client.PreferredFormat = ResourceFormat.Json;
var query = new string[] { "identifier=https://fhir.nhs.uk/Id/sds-user-id|S001" };
var bundle = client.Search("Practitioner", query);
FhirSerializer.SerializeResourceToJson(bundle).Dump();

Java

FhirContext ctx = new FhirContext();
IGenericClient client = ctx.newRestfulGenericClient("gpconnect.aprovider.nhs.net/GP001/STU3/1/");
Bundle bundle = client.search().forResource(Practitioner.class)
.where(new TokenClientParam("identifier").exactly().systemAndCode("https://fhir.nhs.uk/Id/sds-user-id", "S001"))
.encodedJson()
.execute();