Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

FHIR resource link

https://www.hl7.org/fhir/patient.html

FHIR definition

Demographics and other administrative information about an individual or animal receiving care or other health-related services.

PSI use case

unique client for which we have at least 1 identifier

FHIR required properties

see below

PSI required properties*

Country and PsiProjectCode *

At least one patient identifier

Extensions

Implemented: none

Under consideration:

  • BirthSex - Jul 2022

  • enforcement of identifiers - Aug 2022

  • Gender values - Aug 2022

Sample payload

(minimum set)

...

Property

Required by PSI?

Notes

PSI tags

Status
colourGreen
titleYes

Country ISO-2 code

Project Code

PENDING: implementation of this property

identifier

Status
colourGreen
titleYes
- at least one unique value should be provided.

At least one identifier (UNIQUE) must be provided. Examples:

  • Social ID (phone number, email, google, facebook, whatsapp, phone, zalo)

  • If phone number is to be shared, a second keyword must be provided

  • National ID

  • Social Security number

Uniqueness is across Country

name

optional

If provided, please state:

  • use (usual | official | temp | nickname | anonymous | old | maiden)

  • period (start date)

telecom

optional

If an email or a phone number is provided, always include:

  • use (home | work | temp | old | mobile)

  • period (start date)

  • phone: always use +country code, no spaces

birthDate

optional

If we do not know the exact date of birth, store as

  • YYYY-MM

  • YYYY

Age ranges: not supported

address

optional

If provided, always include:

  • use (usual | official | temp | nickname | anonymous | old | maiden)

  • type: (postal | physical | both)

  • country: ISO 3166 2 letters code

  • period (start date)

communication/language

Status
colourGreen
titleYes

FHIR recommendation: BCP-47 code - wikipedia

PENDING: how do we handle languages not in the BCP-47 subset?. Example: Shona (Zimbabwe)

should we consider ISO 639 ?