PACIO Advance Directive Interoperability Implementation Guide
0.1.0 - STU 1 Ballot

Publication Build: This will be filled in by the publication tooling

## CapabilityStatement: PADI CapabilityStatement

Raw OpenAPI-Swagger Definition file | Download

## PADI CapabilityStatement

- Implementation Guide Version: 0.0.1
- FHIR Version: 4.0.1
- Supported formats: xml, json
- Published: 2021-07-26
- Published by: HL7 Patient Empowerment Working Group (PE WG)

This Section describes the expected capabilities of the PACIO Advance Directive Interoperability (ADI) Server actor which is responsible for providing responses to the queries submitted by the ADI Requestors.

There are two primary vehicles in which Advance Directive Information can be conveyed: DocumentReference and Bundle. Through a DocumentReference, the ADI may be encoded inside directly as content data or referred to through a content reference (pointing to the ADI included in a resource like Binary) or reference a Bundle with the type=document for FHIR encoded data. The resources referred to by the Composition in the document bundle include Patient, Observation,Goal, ServiceRequest, Organization, RelatedPerson, Consent, List, and Provenance.

### FHIR RESTful Capabilities

The ADI 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 ADI interactions.
5. Support the searchParameters on each profile individually and in combination.

The ADI Server SHOULD:

1. Support xml source formats for all ADI 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 response code.

### RESTful Capabilities by Resource/Profile:

Summary of Search Criteria

Resource Type | Supported Profiles | Supported Searches | Supported `_includes` | Supported `_revincludes` | Supported Operations
--- | --- | --- | --- | --- | ---
Bundle |  | _id, composition, identifier, timestamp, type |  |  |
Composition | PADI-Header, PADI-PACPComposition |  |  |  |
Consent | PADI-HealthcareAgentAuthority, PADI-ConsentForHealthcareAgent |  |  |  |
DocumentReference | PADI-DocumentReference | _id, authenticator, author, category, contenttype, custodian, date, description, encounter, event, facility, format, identifier, language, location, patient, period, related, relatesto, relation, relationship, security-label, setting, status, subject, type |  |  |
Goal | PADI-PersonalGoal |  |  |  |
List | PADI-PersonalPrioritiesOrganizer |  |  |  |
Observation | PADI-PMOLSTObservation, PADI-PersonalInterventionPreference, PADI-OrganDonationObservation, PADI-AutopsyObservation, PADI-CareExperiencePreference |  |  |  |
Organization |  |  |  |  |
Patient | us-core-patient | _id, active, address, address-city, address-country, address-postalcode, address-state, address-use, birthdate, death-date, deceased, email, family, gender, general-practitioner, given, identifier, language, link, name, organization, phone, phonetic, telecom, race, ethnicity |  |  |
Provenance | PADI-Provenance |  |  |  |
RelatedPerson | PADI-HealthcareAgent, PADI-Guardian |  |  |  |

#### Bundle

Conformance Expectation: SHALL

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `read`, `update`.
- SHOULD support `search-type`, `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Bundle resource using:
  `GET [base]/Bundle/[id]`
- A Server SHOULD be capable of returning a Bundle resource using:
  `GET [base]/Bundle/[id]/_history/vid`

Search Parameter Summary:

Conformance | Parameter | Type | Example
--- | --- | --- | ---
SHOULD | _id | token | `GET [base]/Bundle?_id=[id]`
SHOULD | composition | reference | `GET [base]/Bundle?composition=[composition]`
SHOULD | identifier | token | `GET [base]/Bundle?identifier=[system]|[code]`
SHOULD | timestamp | date | `GET [base]/Bundle?timestamp=[timestamp]`
SHOULD | type | token | `GET [base]/Bundle?type=[system]|[code]`

#### Composition

Conformance Expectation: SHALL

Supported Profiles: PADI-Header, PADI-PACPComposition

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Composition resource using:
  `GET [base]/Composition/[id]`
- A Server SHOULD be capable of returning a Composition resource using:
  `GET [base]/Composition/[id]/_history/vid`

#### Consent

Conformance Expectation: SHALL

Supported Profiles: PADI-HealthcareAgentAuthority, PADI-ConsentForHealthcareAgent

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Consent resource using:
  `GET [base]/Consent/[id]`
- A Server SHOULD be capable of returning a Consent resource using:
  `GET [base]/Consent/[id]/_history/vid`

#### DocumentReference

Conformance Expectation: SHALL

Supported Profiles: PADI-DocumentReference

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a DocumentReference resource using:
  `GET [base]/DocumentReference/[id]`
- A Server SHOULD be capable of returning a DocumentReference resource using:
  `GET [base]/DocumentReference/[id]/_history/vid`

Search Parameter Summary:

Conformance | Parameter | Type | Example
--- | --- | --- | ---
SHALL | _id | token | `GET [base]/DocumentReference?_id=[id]`
MAY | authenticator | reference | `GET [base]/DocumentReference?authenticator=[authenticator]`
MAY | author | reference | `GET [base]/DocumentReference?author=[author]`
SHOULD | category | token | `GET [base]/DocumentReference?category=[system]|[code]`
SHOULD | contenttype | token | `GET [base]/DocumentReference?contenttype=[system]|[code]`
SHALL | custodian | reference | `GET [base]/DocumentReference?custodian=[custodian]`
SHALL | date | date | `GET [base]/DocumentReference?date=[date]`
MAY | description | string | `GET [base]/DocumentReference?description=[description]`
MAY | encounter | reference | `GET [base]/DocumentReference?encounter=[encounter]`
MAY | event | token | `GET [base]/DocumentReference?event=[system]|[code]`
MAY | facility | token | `GET [base]/DocumentReference?facility=[system]|[code]`
SHOULD | format | token | `GET [base]/DocumentReference?format=[system]|[code]`
SHALL | identifier | token | `GET [base]/DocumentReference?identifier=[system]|[code]`
MAY | language | token | `GET [base]/DocumentReference?language=[system]|[code]`
MAY | location | uri | `GET [base]/DocumentReference?location=[uri]`
SHALL | patient | reference | `GET [base]/DocumentReference?patient=[patient]`
SHALL | period | date | `GET [base]/DocumentReference?period=[period]`
MAY | related | reference | `GET [base]/DocumentReference?related=[related]`
MAY | relatesto | reference | `GET [base]/DocumentReference?relatesto=[relatesto]`
MAY | relation | token | `GET [base]/DocumentReference?relation=[system]|[code]`
MAY | relationship | composite | `GET [base]/DocumentReference?relationship=[code]&[value]`
MAY | security-label | token | `GET [base]/DocumentReference?security-label=[system]|[code]`
MAY | setting | token | `GET [base]/DocumentReference?setting=[system]|[code]`
SHALL | status | token | `GET [base]/DocumentReference?status=[status]`
MAY | subject | reference | `GET [base]/DocumentReference?subject=[subject]`
SHALL | type | token | `GET [base]/DocumentReference?type=[system]|[code]`

#### Goal

Conformance Expectation: SHALL

Supported Profiles: PADI-PersonalGoal

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Goal resource using:
  `GET [base]/Goal/[id]`
- A Server SHOULD be capable of returning a Goal resource using:
  `GET [base]/Goal/[id]/_history/vid`

#### List

Conformance Expectation: SHALL

Supported Profiles: PADI-PersonalPrioritiesOrganizer

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a List resource using:
  `GET [base]/List/[id]`
- A Server SHOULD be capable of returning a List resource using:
  `GET [base]/List/[id]/_history/vid`

#### Observation

Conformance Expectation: SHALL

Supported Profiles: PADI-PMOLSTObservation, PADI-PersonalInterventionPreference, PADI-OrganDonationObservation, PADI-AutopsyObservation, PADI-CareExperiencePreference

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Observation resource using:
  `GET [base]/Observation/[id]`
- A Server SHOULD be capable of returning a Observation resource using:
  `GET [base]/Observation/[id]/_history/vid`

#### Organization

Conformance Expectation: SHALL

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Organization resource using:
  `GET [base]/Organization/[id]`
- A Server SHOULD be capable of returning a Organization resource using:
  `GET [base]/Organization/[id]/_history/vid`

#### Patient

Conformance Expectation: SHALL

Supported Profiles: us-core-patient

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Patient resource using:
  `GET [base]/Patient/[id]`
- A Server SHOULD be capable of returning a Patient resource using:
  `GET [base]/Patient/[id]/_history/vid`

Search Parameter Summary:

Conformance | Parameter | Type | Example
--- | --- | --- | ---
SHALL | _id | token | `GET [base]/Patient?_id=[id]`
SHOULD | active | token | `GET [base]/Patient?active=[system]|[code]`
MAY | address | string | `GET [base]/Patient?address=[address]`
MAY | address-city | string | `GET [base]/Patient?address-city=[address-city]`
MAY | address-country | string | `GET [base]/Patient?address-country=[address-country]`
MAY | address-postalcode | string | `GET [base]/Patient?address-postalcode=[address-postalcode]`
MAY | address-state | string | `GET [base]/Patient?address-state=[address-state]`
MAY | address-use | token | `GET [base]/Patient?address-use=[system]|[code]`
SHALL | birthdate | date | `GET [base]/Patient?birthdate=[birthdate]`
MAY | death-date | date | `GET [base]/Patient?death-date=[death-date]`
MAY | deceased | token | `GET [base]/Patient?deceased=[system]|[code]`
SHOULD | email | token | `GET [base]/Patient?email=[system]|[code]`
SHALL | family | string | `GET [base]/Patient?family=[family]`
SHALL | gender | token | `GET [base]/Patient?gender=[system]|[code]`
MAY | general-practitioner | reference | `GET [base]/Patient?general-practitioner=[general-practitioner]`
SHALL | given | string | `GET [base]/Patient?given=[given]`
SHALL | identifier | token | `GET [base]/Patient?identifier=[system]|[code]`
MAY | language | token | `GET [base]/Patient?language=[system]|[code]`
MAY | link | reference | `GET [base]/Patient?link=[link]`
SHALL | name | string | `GET [base]/Patient?name=[name]`
MAY | organization | reference | `GET [base]/Patient?organization=[organization]`
SHOULD | phone | token | `GET [base]/Patient?phone=[system]|[code]`
MAY | phonetic | string | `GET [base]/Patient?phonetic=[phonetic]`
SHOULD | telecom | token | `GET [base]/Patient?telecom=[system]|[code]`
MAY | race | token | `GET [base]/Patient?race=[system]|[code]`
MAY | ethnicity | token | `GET [base]/Patient?ethnicity=[system]|[code]`

#### Provenance

Conformance Expectation: SHALL

Supported Profiles: PADI-Provenance

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a Provenance resource using:
  `GET [base]/Provenance/[id]`
- A Server SHOULD be capable of returning a Provenance resource using:
  `GET [base]/Provenance/[id]/_history/vid`

#### RelatedPerson

Conformance Expectation: SHALL

Supported Profiles: PADI-HealthcareAgent, PADI-Guardian

Reference Policy: `resolves`

Profile Interaction Summary:

- SHALL support `create`, `search-type`, `read`, `update`.
- SHOULD support `vread`, `history-instance`.

Fetch and Search Criteria:

- A Server SHALL be capable of returning a RelatedPerson resource using:
  `GET [base]/RelatedPerson/[id]`
- A Server SHOULD be capable of returning a RelatedPerson resource using:
  `GET [base]/RelatedPerson/[id]/_history/vid`