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

PSI required properties*

identifier**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)

PSI tags

Country ISO-2 code

Project Code

identifier

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

BCP-47 code - wikipedia

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

should we consider ISO 639