Consent - FHIR
- Rodolfo Melia
- Carlos
|
|
|---|---|
FHIR resource link | http://hl7.org/fhir/R4B/consent.html CURRENT USED BY PSI http://hl7.org/fhir/R5/consent.html Consent - FHIR v6.0.0-ballot2 SIGNIFICANT CHANGES |
FHIR definition | A record of a healthcare consumer’s choices, which permits or denies identified recipient(s) or recipient role(s) to perform one or more actions within a given policy context, for specific purposes and periods of time. |
PSI use case | Consumer’s acceptance to T&C or other documentation |
Required properties (see details below) |
|
Extensions | Sept 2022 - enforcement of required properties for PSI under consideration |
Sample payload | {
"resourceType": "Consent",
"status": "active", //active | inactive
"scope": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/consentscope",
"code": "patient-privacy"
}
]
},
"category": [
{
"coding": [
{
"system": "http://loinc.org",
"code": "59284-0"
}
]
}
],
"patient": {
"reference": "Patient/f001",
},
"performer":{
"reference": "Patient/f001",
},
"dateTime": "2016-05-11",
"organization": {
"reference": "Organization/f001"
},
"language": "en",
"sourceReference":{
// TODO
},
// Either a Policy or PolicyRule policy.exists() or policyRule.exists()
"policyRule": {
"coding": [
{
"system": "http://terminology.hl7.org/CodeSystem/v3-ActCode",
"code": "OPTIN"
}
]
},
"provision": {
"period": {
"start": "1964-01-01",
"end": "2016-01-01" //when person opt-outs
}
}
} |
Resource Dependencies | Patient |
Notes for Consent FHIR resource, per property
Property | Set | Notes |
|---|---|---|
tags | REQUIRED [psi] | countryISO & projectID |
status | REQUIRED [fhir] | draft | proposed | active | rejected | inactive | entered-in-error
|
period FHIR v5 | REQUIRED [psi] | Effective period for this Consent. Effective period for this Consent Resource and all provisions unless specified in that provision |
scope | REQUIRED [fhir 4.3] - not in 5.0 | For PSI’s use case, we will normally set scope to: |
category | REQUIRED [fhir] | “59284-0” based on http://loinc.org Patient Consent |
patient | REQUIRED for patients [psi] WILL CHANGE for 5.0 | If the consent relates to a patient [psi] the related record must be passed. |
performer | REQUIRED [psi] | patient id - if collected directly from the consumer - e.g. on a bot practitioner id - if collected by a health worker |
dateTime | REQUIRED [psi] | date time that the patient agreed to the consent - DateTime should be recorded with associated TimeZone
DateTime should be UTC - Frontend apps and Analytics will need to convert to local timezone. |
organization | REQUIRED [psi] | reference to Organization ID - who issued the consent document |
language | REQUIRED [psi] | bpc-47 - en/es/fr/ |
source | REQUIRED [psi] | /source reference = document reference ID |
policy OR policyRule | REQUIRED [fhir] | code: OPTIN (see code example) |
provision.period | REQUIRED [psi] | the time period for which the consent applies, normally just start date. The end date is set if the patients opt-out or the consent is superseded by another consent. In FHIR v5, a field So data would be moved from consent.provision.period to consent.period. |
*in addition to: countryISO & projectID