http://fhir.patientsknowbest.com/operation/generate-invitation-tokens

[Prod Resource]

https://www.hl7.org/fhir/STU3/operationdefinition.html

https://www.hl7.org/fhir/STU3/operations.html

name

"generate-invitation-tokens"

status

"active"

kind

"operation"

description

This operation allows:

• a system to generate invitation tokens for 1 or many patients identified by national identifier.

Generates invitation tokens for the patient identified by patientIdentifier (e.g. NHS). Multiple patient identifiers can be supplied as the input to the operation. This allows the calling system to work in batches.

In addition to the OAuth 2.0 access token, the X-Org-Public-Id HTTP header must be provided in the request to specify the organisation that wants to generate the tokens. The parameter will be the UUID of the PKB organisation.

code

"generate-invitation-tokens"

resource

• "Organization"

system

false

type

true

instance

false

parameter

• parameter[0]

  • name = "patientIdentifier"

  • use = "in"

  • min = 1

  • max = "500"

  • type = "token"

Currently only NHS, CHI and Health & Care numbers are supported. Reference: https://pkbdev.atlassian.net/wiki/spaces/api/pages/3365077531/Identifier+Systems. If an unsupported system identifier is supplied on the request then the whole request will be rejected and an error returned.

• parameter[1]

  • name = "patientTokens"

  • use = "out"

  • min = 1

  • max = "500"

  • type = "multi part parameter"

patientTokens will not be returned where patient is deceased, not found, already registered or has no date of birth. status-query should be used prior to this operation to confirm the patient is applicable for invitation.

• parameter[2]

  • name = "patientIdentifier"

  • use = "out"

  • min = 1

  • max = "1"

  • type = "token"

  • part = patientTokens

• parameter[3]

  • name = "token"

  • use = "out"

  • min = 1

  • max = "1"

  • type = "string"

  • part = patientTokens

• parameter[4]

  • name = "code"

  • use = "out"

  • min = 1

  • max = "1"

  • type = "string"

  • part = patientTokens

• parameter[5]

  • name = "expiry"

  • use = "out"

  • min = 1

  • max = "1"

  • type = "DateTime"

  • part = patientTokens

PKB customer sites: deploy | developer | information governance | procurement | manual

© Patients Know Best, Ltd. Registered in England and Wales Number: 6517382. VAT Number: GB 944 9739 67.

This API specification and design is licensed under a Creative Commons Attribution 4.0 International License.