PACIO Personal Functioning and Engagement Implementation Guide
2.0.0 - STU 2 United States of America flag

This page is part of the PACIO Personal Functioning and Engagement Implementation Guide (v2.0.0: STU 2) based on FHIR (HL7® FHIR® Standard) R4. This is the current published version. For a full list of available versions, see the Directory of published versions

CapabilityStatement: Personal Functioning and Engagement Capability Statement

Official URL: http://hl7.org/fhir/us/pacio-pfe/CapabilityStatement/pacio-pfe-cap Version: 2.0.0
Standards status: Trial-use Active as of 2022-08-12 Maturity Level: 3 Computable Name: Personal_Functioning_And_Engagement_CapabilityStatement

This Capability Statement defines the expected capabilities of a Personal Functioning and Engagement FHIR server conforming to the Personal Functioning and Engagement Implementation Guide.

Raw OpenAPI-Swagger Definition file | Download

Personal Functioning and Engagement Capability Statement

  • Implementation Guide Version: 2.0.0
  • FHIR Version: 4.0.1
  • Supported Formats: xml, json
  • Supported Patch Formats: application/json-patch+json
  • Published on: 2022-08-12 00:00:00+0000
  • Published by: HL7 International / Patient Care

Note to Implementers: FHIR Capabilities

Any FHIR capability may be 'allowed' by the system unless explicitly marked as 'SHALL NOT'. A few items are marked as MAY in the Implementation Guide to highlight their potential relevance to the use case.

SHALL Support the Following Implementation Guides

FHIR RESTful Capabilities

Mode: server

The PFE Server SHALL:

  1. Support all profiles defined in this Implementation Guide.
  2. Implement the RESTful behavior according to the FHIR specification.
  3. Return the following response classes:
    • (Status 400): invalid parameter
    • (Status 401/4xx): unauthorized request
    • (Status 403): insufficient scope
    • (Status 404): unknown resource
    • (Status 410): deleted resource.
  4. Support json source formats for all PFE interactions.
  5. Support the searchParameters on each profile individually and in combination.

The PFE Server SHOULD:

  1. Support xml source formats for all PFE interactions.
Security
  1. See the Guidance section for requirements and recommendations.
  2. A server SHALL reject any unauthorized requests by returning an HTTP 401 "Unauthorized", HTTP 403 "Forbidden", or HTTP 404 "Not Found" response code.
Summary of System-wide Interactions
  • MAY support the batchinteraction.
  • MAY support the search-systeminteraction.

Capabilities by Resource/Profile

Summary

The summary table lists the resources that are part of this configuration, and for each resource it lists:

  • The relevant profiles (if any)
  • The interactions supported by each resource (Read, Search, Update, and Create, are always shown, while VRead, Patch, Delete, History on Instance, or History on Type are only present if at least one of the resources has support for them.
  • The required, recommended, and some optional search parameters (if any).
  • The linked resources enabled for _include
  • The other resources enabled for _revinclude
  • The operations on the resource (if any)
Resource TypeProfileRV-RSUPCDH-IH-TSearches_include_revincludeOperations
ObservationSupported Profiles
  Personal Functioning and Engagement Clinical Test Observationversion: null2.0.0)
  Personal Functioning and Engagement Collectionversion: null2.0.0)
  Personal Functioning and Engagement Single Observationversion: null2.0.0)
yyyyyyyyydate, combo-data-absent-reason, code, combo-code-value-quantity, subject, component-data-absent-reason, value-concept, value-date, code-value-string, component-code-value-quantity, based-on, code-value-date, patient, specimen, component-code, code-value-quantity, combo-code-value-concept, value-string, identifier, performer, combo-code, method, value-quantity, component-value-quantity, data-absent-reason, combo-value-quantity, encounter, code-value-concept, component-code-value-concept, component-value-concept, category, device, combo-value-concept, status, patient+code+date, patient+category+status, patient+category+date, patient+category, patient+codeObservation.subject, Observation.based-on, Observation.patient, Observation.specimen, Observation.context, Observation.performer, Observation.encounter, Observation.deviceChargeItem.service, ClinicalImpression.finding-ref, ClinicalImpression.investigation, DiagnosticReport.result, Immunization.reaction, ImmunizationRecommendation.information, MedicationStatement.part-of, Procedure.part-of, QuestionnaireResponse.parent
DiagnosticReportSupported Profiles
  Personal Functioning and Engagement Narrative History of Statusversion: null2.0.0)
yyyyyyyyydate, category, status, code, patient, identifier, encounter, patient+code+date, patient+status, patient+category+date, patient+category, patient+codeDiagnosticReport.based-on, DiagnosticReport.subject, DiagnosticReport.patient, DiagnosticReport.encounter, DiagnosticReport.media, DiagnosticReport.performer, DiagnosticReport.result, DiagnosticReport.results-interpreter, DiagnosticReport.specimen
DeviceUseStatementSupported Profiles
  Personal Functioning and Engagement Use of Deviceversion: null2.0.0)
yyyyyyyyyidentifier, subject, patient, deviceDeviceUseStatement.subject, DeviceUseStatement.patient, DeviceUseStatement.device
ConditionSupported Profiles
  Personal Functioning and Engagement Condition Encounter Diagnosis Profileversion: null2.0.0)
  Personal Functioning and Engagement Condition Problems and Health Concerns Profileversion: null2.0.0)
yyyyyyyyyidentifier, status, abatement date, onset date, recorded date, subject, patient, bodySite, asserter, recordedDate, code, encounter, patient+recorded-date, patient+asserted-date, patient+category+clinical-status, patient+onset-date, patient+abatement-date, patient+clinical-status, patient+category+encounter, patient+code, patient+categoryCondition.identifier, Condition.subject, Condition.patient, Condition.bodySite, Condition.asserter, Condition.recordedDate, Condition.code, Condition.encounter
GoalSupported Profiles
  Personal Functioning and Engagement Goal Profileversion: null2.0.0)
yyyyyyyyyidentifier, subject, patient, target date, lifecycle status, achievementStatus, addresses, patient+target-date, patient+description, patient+lifecycle-statusGoal.identifier, Goal.subject, Goal.patient, Goal.achievementStatus, Goal.addresses
NutritionOrderSupported Profiles
  Personal Functioning and Engagement Nutrition Order Profileversion: null2.0.0)
yyyyyyyyyidentifier, patient, encounter, orderer, statusNutritionOrder.identifier, NutritionOrder.patient, NutritionOrder.encounter, NutritionOrder.orderer, NutritionOrder.status
ServiceRequestSupported Profiles
  Personal Functioning and Engagement Service Request Profileversion: null2.0.0)
yyyyyyyyyidentifier, subject, patient, status, code, category, authored, requester, performer, reason reference, patient+category+authored, patient+status, patient+category, patient+code+authored, patient+codeServiceRequest.identifier, ServiceRequest.subject, ServiceRequest.patient, ServiceRequest.status, ServiceRequest.code, ServiceRequest.requester, ServiceRequest.performer, ServiceRequest.reasonReference

Resource Conformance: SHALL Observation

Core FHIR Resource
Observation
Reference Policy
literal, logical
Interaction summary
  • SHALL support create, update, read, search-type.
  • SHOULD support vread, history-instance.
  • MAY support delete, history-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLdatedate

Obtained date/time. If the obtained element is a period, a date that falls in the period

SHALLcodetoken

The code of the observation type

SHALLpatientreference

The subject that the observation is about (if patient)

SHALLcategorytoken

The classification of the type of observation

SHALLstatustoken

The status of the observation

MAYcombo-data-absent-reasontoken

The reason why the expected value in the element Observation.value[x] or Observation.component.value[x] is missing.

MAYcombo-code-value-quantitycomposite

Code and quantity value parameter pair, including in components

MAYsubjectreference

The subject that the observation is about

MAYcomponent-data-absent-reasontoken

The reason why the expected value in the element Observation.component.value[x] is missing.

MAYvalue-concepttoken

The value of the observation, if the value is a CodeableConcept

MAYvalue-datedate

The value of the observation, if the value is a date or period of time

MAYcode-value-stringcomposite

Code and string value parameter pair

MAYcomponent-code-value-quantitycomposite

Component code and component quantity value parameter pair

MAYbased-onreference

Reference to the test or procedure request.

MAYcode-value-datecomposite

Code and date/time value parameter pair

MAYspecimenreference

Specimen used for this observation

MAYcomponent-codetoken

The component code of the observation type

MAYcode-value-quantitycomposite

Code and quantity value parameter pair

MAYcombo-code-value-conceptcomposite

Code and coded value parameter pair, including in components

MAYvalue-stringstring

The value of the observation, if the value is a string, and also searches in CodeableConcept.text

MAYidentifiertoken

The unique id for a particular observation

MAYperformerreference

Who performed the observation

MAYcombo-codetoken

The code of the observation type or component type

MAYmethodtoken

The method used for the observation

MAYvalue-quantityquantity

The value of the observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)

MAYcomponent-value-quantityquantity

The value of the component observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)

MAYdata-absent-reasontoken

The reason why the expected value in the element Observation.value[x] is missing.

MAYcombo-value-quantityquantity

The value or component value of the observation, if the value is a Quantity, or a SampledData (just search on the bounds of the values in sampled data)

MAYencounterreference

Encounter related to the observation

MAYcode-value-conceptcomposite

Code and coded value parameter pair

MAYcomponent-code-value-conceptcomposite

Component code and component coded value parameter pair

MAYcomponent-value-concepttoken

The value of the component observation, if the value is a CodeableConcept

MAYdevicereference

The Device that generated the observation data.

MAYcombo-value-concepttoken

The value or component value of the observation, if the value is a CodeableConcept

Combined Search Parameters
ConformanceParametersTypes
SHALLpatient+category+datereference+token+date
SHALLpatient+categoryreference+token
SHALLpatient+codereference+token
SHOULDpatient+code+datereference+token+date
SHOULDpatient+category+statusreference+token+token

Resource Conformance: MAY DiagnosticReport

Core FHIR Resource
DiagnosticReport
Reference Policy
literal, logical
Interaction summary
  • SHALL support create, update, read, search-type.
  • SHOULD support vread, history-instance.
  • MAY support delete, history-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLdatedate

Obtained date/time. If the obtained element is a period, a date that falls in the period

SHALLcategorytoken

The classification of the type of diagnostic report

SHALLstatustoken

Search by status

SHALLcodetoken

The code of the report type

SHALLpatientreference

The subject that the report is about (if patient)

MAYidentifiertoken

The unique id for a particular report

MAYencounterreference

Encounter related to the report

Combined Search Parameters
ConformanceParametersTypes
SHALLpatient+category+datereference+token+date
SHALLpatient+categoryreference+token
SHALLpatient+codereference+token
SHOULDpatient+code+datereference+token+date
SHOULDpatient+statusreference+token

Resource Conformance: SHOULD DeviceUseStatement

Core FHIR Resource
DeviceUseStatement
Reference Policy
literal, logical
Interaction summary
  • SHOULD support create, update, delete, read.
  • MAY support vread, history-instance, history-type, search-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
MAYidentifiertoken

Search by identifier

MAYsubjectreference

Search by subject

MAYpatientreference

Search by subject - a patient

MAYdevicereference

Search by device

 

Resource Conformance: SHOULD Condition

Core FHIR Resource
Condition
Reference Policy
literal, logical
Interaction summary
  • SHOULD support create, update, delete, read.
  • MAY support vread, history-instance, history-type, search-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLstatustoken

Search by status

SHALLabatement datedate

Search by abatement date

SHALLonset datedate

Search by onset date

SHALLrecorded datedate

Search by recorded date

SHALLsubjectreference

Search by subject

SHALLpatientreference

Search by subject - a patient

SHALLcodetoken

Search by code

SHALLencounterreference

Search by encounter

MAYidentifiertoken

Search by identifier

MAYbodySitetoken

Search by body site

MAYasserterreference

Search by asserter

MAYrecordedDatedate

Search by recorded date

Combined Search Parameters
ConformanceParametersTypes
SHALLpatient+categoryreference+<unknown>
SHOULDpatient+recorded-datereference+<unknown>
SHOULDpatient+asserted-datereference+<unknown>
SHOULDpatient+category+clinical-statusreference+<unknown>+<unknown>
SHOULDpatient+onset-datereference+<unknown>
SHOULDpatient+abatement-datereference+<unknown>
SHOULDpatient+clinical-statusreference+<unknown>
SHOULDpatient+category+encounterreference+<unknown>+reference
SHOULDpatient+codereference+token

Resource Conformance: SHOULD Goal

Core FHIR Resource
Goal
Reference Policy
literal, logical
Interaction summary
  • SHOULD support create, update, delete, read.
  • MAY support vread, history-instance, history-type, search-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLsubjectreference

Search by subject

SHALLpatientreference

Search by subject - a patient

SHALLtarget datedate

Search by goal target date

SHALLlifecycle statustoken

Search by lifecycle status

MAYidentifiertoken

Search by identifier

MAYachievementStatustoken

Search by achievement status

MAYaddressesreference

Search by addresses

Combined Search Parameters
ConformanceParametersTypes
SHOULDpatient+target-datereference+<unknown>
SHOULDpatient+descriptionreference+<unknown>
SHOULDpatient+lifecycle-statusreference+<unknown>

Resource Conformance: SHOULD NutritionOrder

Core FHIR Resource
NutritionOrder
Reference Policy
literal, logical
Interaction summary
  • SHOULD support create, update, delete, read.
  • MAY support vread, history-instance, history-type, search-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
MAYidentifiertoken

Search by identifier

MAYpatientreference

Search by subject - a patient

MAYencounterreference

Search by encounter

MAYordererreference

Search by orderer

MAYstatustoken

Search by status

 

Resource Conformance: SHOULD ServiceRequest

Core FHIR Resource
ServiceRequest
Reference Policy
literal, logical
Interaction summary
  • SHOULD support create, update, delete, read.
  • MAY support vread, history-instance, history-type, search-type, patch.

Search Parameters
ConformanceParameterTypeDocumentation
SHALLsubjectreference

Search by subject

SHALLpatientreference

Search by subject - a patient

SHALLstatustoken

Search by status

SHALLcodetoken

Search by code

SHALLcategorytoken

Search by category

SHALLauthoreddate

Search by date authored

MAYidentifiertoken

Search by identifier

MAYrequesterreference

Search by requester

MAYperformerreference

Search by performer

MAYreason referencereference

Search by reason reference

Combined Search Parameters
ConformanceParametersTypes
SHALLpatient+category+authoredreference+token+date
SHALLpatient+categoryreference+token
SHALLpatient+codereference+token
SHOULDpatient+statusreference+token
SHOULDpatient+code+authoredreference+token+date