IE (Ireland) Core Implementation Guide
1.0.0-ballot - Ballot
Publication Build: This will be filled in by the publication tooling
Official URL: http://iehr.ai/fhir/ie/core/CapabilityStatement/ie-core-server | Version: 1.0.0-ballot | |||
Standards status: Trial-use | Maturity Level: 3 | Computable Name: IeCoreServerCapabilityStatement | ||
Other Identifiers: OID:1.3.6.1.4.1.54392.5.2690.13.2 | ||||
Copyright/Legal: iEHR.ai, all rights reserved Creative Commons License |
This Section describes the expected capabilities of the IE Core Server actor which is responsible for providing responses to the queries submitted by the IE Core Requestors. The complete list of FHIR profiles, RESTful operations, and search parameters supported by IE Core Servers are defined.
Raw OpenAPI-Swagger Definition file | Download
Generated Narrative: CapabilityStatement ie-core-server
json
, SHOULD support xml
application/json-patch+json
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.
server
The IE Core Server SHALL:
The IE Core Server SHOULD:
meta.profile
attribute for each instance.
- See the General Security Considerations section for requirements and recommendations.
- A server SHALL reject any unauthorized requests by returning an
HTTP 401
"Unauthorized",HTTP 403
"Forbidden", orHTTP 404
"Not Found"
transaction
interaction.batch
interaction.search-system
interaction.history-system
interaction.The summary table lists the resources that are part of this configuration, and for each resource it lists:
_include
_revinclude
Resource Type | Profile | R | V-R | S | U | P | C | D | H-I | H-T | Searches | _include | _revinclude | Operations |
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
AllergyIntolerance | Supported Profiles IE Core AllergyIntolerance Profile | y | y | y | y | y | y | y | y | y | clinical-status, patient, patient+clinical-status | Provenance:target | ||
CarePlan | Supported Profiles IE Core CarePlan Profile | y | y | y | y | y | y | y | y | y | category, date, patient, status, patient+category+status+date, patient+category+date, patient+category, patient+category+status | Provenance:target | ||
CareTeam | Supported Profiles IE Core CareTeam Profile | y | y | y | y | y | y | y | y | y | patient, role, status, patient+status, patient+role | CareTeam:participant:PractitionerRole , CareTeam:participant:Practitioner , CareTeam:participant:Patient , CareTeam:participant:RelatedPerson | Provenance:target | |
Condition | Supported Profiles IE Core Condition Encounter Diagnosis Profile IE Core Condition Problems and Health Concerns Profile | y | y | y | y | y | y | y | y | y | abatement-date, asserted-date, category, clinical-status, code, encounter, onset-date, patient, recorded-date, _lastUpdated, patient+category+clinical-status, patient+onset-date, patient+abatement-date, patient+clinical-status, patient+asserted-date, patient+code, patient+category+encounter, patient+_lastUpdated, patient+recorded-date, patient+category | Provenance:target | ||
Coverage | Supported Profiles IE Core Coverage Profile | y | y | y | y | y | y | y | y | y | patient | Provenance:target | ||
Device | Supported Profiles IE Core Implantable Device Profile | y | y | y | y | y | y | y | y | y | patient, status, type, patient+status, patient+type | Provenance:target | ||
DiagnosticReport | Supported Profiles IE Core DiagnosticReport Profile for Report and Note Exchange IE Core DiagnosticReport Profile for Laboratory Results Reporting | y | y | y | y | y | y | y | y | y | category, code, date, _lastUpdated, patient, status, patient+code, patient+category+date, patient+code+date, patient+status, patient+category+_lastUpdated, patient+category | Provenance:target | ||
DocumentReference | Supported Profiles IE Core DocumentReference Profile | y | y | y | y | y | y | y | y | y | _id, category, date, patient, period, status, type, patient+type, patient+category+date, patient+type+period, patient+status, patient+category | Provenance:target | $docref | |
Encounter | Supported Profiles IE Core Encounter Profile | y | y | y | y | y | y | y | y | y | _id, class, date, _lastUpdated, discharge-disposition, identifier, location, patient, status, type, date+patient, class+patient, patient+type, patient+_lastUpdated, patient+status, patient+location, patient+discharge-disposition | Provenance:target | ||
Endpoint | y | y | y | y | y | y | y | y | y | |||||
Goal | Supported Profiles IE Core Goal Profile | y | y | y | y | y | y | y | y | y | description, lifecycle-status, patient, target-date, patient+target-date, patient+lifecycle-status, patient+description | Provenance:target | ||
HealthcareService | y | y | y | y | y | y | y | y | y | |||||
Immunization | Supported Profiles IE Core Immunization Profile | y | y | y | y | y | y | y | y | y | date, patient, status, patient+date, patient+status | Provenance:target | ||
Location | Supported Profiles IE Core Location Profile | y | y | y | y | y | y | y | y | y | address, address-city, address-postalcode, address-state, name | |||
Media | y | y | y | y | y | y | y | y | y | |||||
Medication | Supported Profiles IE Core Medication Profile | y | y | y | y | y | y | y | y | y | ||||
MedicationDispense | Supported Profiles IE Core MedicationDispense Profile | y | y | y | y | y | y | y | y | y | patient, status, type, patient+status+type, patient+status | MedicationDispense:medication | Provenance:target | |
MedicationRequest | Supported Profiles IE Core MedicationRequest Profile | y | y | y | y | y | y | y | y | y | authoredon, encounter, intent, patient, status, patient+intent+encounter, patient+intent+authoredon, patient+intent+status, patient+intent | MedicationRequest:medication | Provenance:target | |
Observation | Supported Profiles IE Core Laboratory Result Observation Profile IE Core Observation Pregnancy Status Profile IE Core Observation Pregnancy Intent Profile IE Core Observation Occupation Profile IE Core Respiratory Rate Profile IE Core Simple Observation Profile IE Core Treatment Intervention Preference Profile IE Core Care Experience Preference Profile IE Core Heart Rate Profile IE Core Body Temperature Profile IE Core Pediatric Weight for Height Observation Profile IE Core Pulse Oximetry Profile IE Core Smoking Status Observation Profile IE Core Observation Sexual Orientation Profile IE Core Head Circumference Profile IE Core Body Height Profile IE Core BMI Profile IE Core Observation Screening Assessment Profile IE Core Average Blood Pressure Profile IE Core Blood Pressure Profile IE Core Observation Clinical Result Profile IE Core Pediatric BMI for Age Observation Profile IE Core Pediatric Head Occipital Frontal Circumference Percentile Profile IE Core Body Weight Profile IE Core Vital Signs Profile | y | y | y | y | y | y | y | y | y | category, code, date, _lastUpdated, patient, status, patient+code, patient+category+date, patient+code+date, patient+category+status, patient+category+_lastUpdated, patient+category | Provenance:target | ||
Organization | Supported Profiles IE Core Organization Profile | y | y | y | y | y | y | y | y | y | address, name | |||
Patient | Supported Profiles IE Core Patient Profile | y | y | y | y | y | y | y | y | y | _id, birthdate, death-date, family, gender, given, identifier, name, birthdate+name, family+gender, birthdate+family, gender+name, death-date+family | Provenance:target | ||
Practitioner | Supported Profiles IE Core Practitioner Profile | y | y | y | y | y | y | y | y | y | _id, identifier, name | |||
PractitionerRole | Supported Profiles IE Core PractitionerRole Profile | y | y | y | y | y | y | y | y | y | practitioner, specialty | PractitionerRole:endpoint , PractitionerRole:practitioner | ||
Procedure | Supported Profiles IE Core Procedure Profile | y | y | y | y | y | y | y | y | y | code, date, patient, status, patient+code+date, patient+date, patient+status | Provenance:target | ||
Provenance | Supported Profiles IE Core Provenance Profile | y | y | y | y | y | y | y | y | y | ||||
Questionnaire | Supported Profiles SDCBaseQuestionnaire | y | y | y | y | y | y | y | y | y | ||||
QuestionnaireResponse | Supported Profiles IE Core QuestionnaireResponse Profile | y | y | y | y | y | y | y | y | y | _id, authored, patient, questionnaire, status, patient+questionnaire, patient+authored, patient+status | Provenance:target | ||
RelatedPerson | Supported Profiles IE Core RelatedPerson Profile | y | y | y | y | y | y | y | y | y | _id, name, patient, patient+name | Provenance:target | ||
ServiceRequest | Supported Profiles IE Core ServiceRequest Profile | y | y | y | y | y | y | y | y | y | _id, authored, category, code, patient, status, patient+code, patient+category+authored, patient+code+authored, patient+status, patient+category | Provenance:target | ||
Specimen | Supported Profiles IE Core Specimen Profile | y | y | y | y | y | y | y | y | y | _id, patient | |||
ValueSet | $expand |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | clinical-status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
Conformance | Parameters | Types |
---|---|---|
SHOULD | patient+clinical-status | reference +token |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Additional considerations for systems aligning with HL7 Consolidated (C-CDA) Care Plan requirements:
- IE Core Goal SHOULD be present in CarePlan.goal
- IE Core Condition SHOULD be present in CarePlan.addresses
- Assement and Plan MAY be included as narrative text
Conformance | Parameter | Type | Documentation |
---|---|---|---|
MAY | category | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- In order to access care team member's names, identifiers, locations, and contact information, the CareTeam profile supports several types of care team participants. They are represented as references to other profiles and include the following four profiles which are marked as must support:
- IE Core Practitioner Profile
- IE Core PractitionerRole Profile
- IE Core Patient Profile
- IE Core RelatedPerson Profile
- Although both IE Core Practitioner Profile and IE Core PractitionerRole are must support, the server system is not required to support both types of references, but SHALL support at least one of them.
- The client application SHALL support all four profile references.
- Bacause the IE Core PractitionerRole Profile supplies the provider's location and contact information and a reference to the Practitioner, server systems SHOULD reference it instead of the IE Core Practitioner Profile.
- Servers that support only IE Core Practitioner Profile and do not support the IE Core PractitionerRole Profile SHALL provide implementation specific guidance how to access a provider’s location and contact information using only the Practitioner resource.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHOULD | role | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- For Encounter Diagnosis use the IE Core Condition Encounter Diagnosis Profile.
- When
Condition.category
is "encounter-diagnosis" the encounter, SHOULD be referenced inCondition.encounter
.- For Problems and Health Concerns use the IE Core Condition Problems and Health Concerns Profile.
- When
Condition.category
is a "problems-list-item", the `Condition.clinicalStatus SHOULD NOT be unknown.- There is no single element in Condition that represents the date of diagnosis. It may be the assertedDate Extension,
Condition.onsetDateTime
, orCondition.recordedDate
.
- Although all three are marked as must support, the server is not required to support all.
- A server SHALL support
Condition.recordedDate
.- A server SHALL support at least one of the assertedDate Extension and
Condition.onsetDateTime
. A server may support both, which means they support all three elements.- The client application SHALL support all three elements.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | abatement-date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | asserted-date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | category | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | clinical-status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | code | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | encounter | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | onset-date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | recorded-date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | _lastUpdated | date | A server SHALL document the types of changes that can be detected using this parameter. A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
Conformance | Parameters | Types |
---|---|---|
SHALL | patient+category | reference +token |
SHOULD | patient+category+clinical-status | reference +token +token |
SHOULD | patient+onset-date | reference +date |
SHOULD | patient+abatement-date | reference +date |
SHOULD | patient+clinical-status | reference +token |
SHOULD | patient+asserted-date | reference +date |
SHOULD | patient+code | reference +token |
SHOULD | patient+category+encounter | reference +token +reference |
SHOULD | patient+_lastUpdated | reference +date |
SHOULD | patient+recorded-date | reference +date |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
Implantable medical devices that have UDI information SHALL represent the UDI code in
Device.udiCarrier.carrierHRF
.
- All of the five UDI-PI elements that are present in the UDI code SHALL be represented in the corresponding IE Core Implantable Device Profile element.
UDI may not be present in all scenarios such as historical implantable devices, patient reported implant information, payer reported devices, or improperly documented implants. If UDI is not present and the manufacturer and/or model number information is available, they SHOULD be included to support historical reports of implantable medical devices as follows:
manufacturer ->
Device.manufacturer
model ->Device.model
Servers SHOULD support query by Device.type to allow clients to request the patient's devices by a specific type. Note: The Device.type is too granular to differentiate implantable vs. non-implantable devices.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | type | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
create
This conformance expectation applies only to the IE Core DiagnosticReport Profile for Report and Note exchange profile. The conformance expectation for the IE Core DiagnosticReport Profile for Laboratory Results Reporting is MAY.
vread
, history-instance
.update
, patch
, delete
, history-type
.
- When
DiagnosticReport.category
is "LAB" the encounter, Updates to Meta.lastUpdated SHOULD reflect:
- New laboratory reports
- Changes in the status of laboratory reports including events that trigger the same status (e.g., amended → amended).
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | category | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | code | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | _lastUpdated | date | A server SHALL document the types of changes that can be detected using this parameter. A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
create
, search-type
, read
.vread
, history-instance
.update
, patch
, delete
, history-type
.
- The
DocumentReference.type
binding SHALL support at a minimum the 5 Common Clinical Notes and may extend to the full IE Core DocumentReference Type Value Set- The DocumentReference resources can represent the referenced content using either an address where the document can be retrieved using
DocumentReference.attachment.url
or the content as inline base64 encoded data usingDocumentReference.attachment.data
.
- Although both are marked as must support, the server system is not required to support an address, and inline base64 encoded data, but SHALL support at least one of these elements.
- The client application SHALL support both elements.
- The
content.url
may refer to a FHIR Binary Resource (i.e. [base]/Binary/[id]), FHIR Document Bundle (i.e [base]/Bundle/[id] or another endpoint.
- If the endpoint is outside the FHIR base URL, it SHOULD NOT require additional authorization to access.
- If there are multiple
DocumentReference.content
element repetitions, these SHALL all represent the same document in different format or attachment metadata. The content element SHALL NOT contain different versions of the same content. For version handling use multiple DocumentReferences withDocumentReference.relatesTo
- Every DocumentReference must have a responsible Organization. The organization responsible for the DocumentReference SHALL be present either in
DocumentReference.custodian
or accessible in the Provenance resource targeting the DocumentReference usingProvenance.agent.who
orProvenance.agent.onBehalfOf
.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | |
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | category | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | period | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | type | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
Conformance | Operation | Documentation |
---|---|---|
SHALL | $docref | A server SHALL be capable of responding to a $docref operation and capable of returning at least a reference to a generated CCD document, if available. MAY provide references to other 'on-demand' and 'stable' documents (or 'delayed/deferred assembly') that meet the query parameters as well. If a context date range is supplied the server ** SHOULD** provide references to any document that falls within the date range. If no date range is supplied, then the server SHALL provide references to last or current document(s). SHOULD document what resources, if any, are returned as included resources
|
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
The Encounter resource can represent a reason using either a code with
Encounter.reasonCode
, or a reference withEncounter.reasonReference
to Condition or other resource.
- Although both are marked as must support, the server systems are not required to support both a code and a reference, but they SHALL support at least one of these elements.
- The client application SHALL support both elements.
- if
Encounter.reasonReference
references an Observation, it SHOULD conform to a IE Core Observation if applicable. (for example, a laboratory result should conform to the IE Core Laboratory Result Observation Profile)The location address can be represented by either by the Location referenced by
Encounter.location.location
or indirectly through the Organization referenced byEncounter.serviceProvider
.
- Although both are marked as must support, the server systems are not required to support both
Encounter.location.location
andEncounter.serviceProvider
, but they SHALL support at least one of these elements.- The client application SHALL support both elements.
If the event facility/location differs from the
Encounter.location
, systems SHOULD reference it directly:
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | |
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
SHOULD | identifier | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | class | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | _lastUpdated | date | A server SHALL document the types of changes that can be detected using this parameter. A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | discharge-disposition | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | location | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | type | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
Conformance | Parameters | Types |
---|---|---|
SHALL | date+patient | date +reference |
SHOULD | class+patient | token +reference |
SHOULD | patient+type | reference +token |
SHOULD | patient+_lastUpdated | reference +date |
SHOULD | patient+status | reference +token |
SHOULD | patient+location | reference +reference |
SHOULD | patient+discharge-disposition | reference +token |
resolves
read
, vread
.create
, search-type
, update
, patch
, delete
, history-instance
, history-type
.The Media Resource is a Must Suppot referenced resource when using the IE Core PracitionerRole Profile.
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Although both
Goal.startDate
andGoal.target.dueDate
are marked as must support, the server system is not required to support both, but SHALL support at least one of these elements. The client application SHALL support both elements.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | description | token | |
MAY | lifecycle-status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | target-date | date | A client SHALL provide a value precise to the day. A server SHALL support a value a value precise to the day. |
Conformance | Parameters | Types |
---|---|---|
SHOULD | patient+target-date | reference +date |
SHOULD | patient+lifecycle-status | reference +token |
SHOULD | patient+description | reference +token |
resolves
read
, vread
.create
, search-type
, update
, patch
, delete
, history-instance
, history-type
.The HealthcareService Resource is a referenced resource when using the IE Core PracitionRole Profile and subject to constraint ie-core-13: "SHALL have a practitioner, an organization, a healthcare service, or a location."
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Based upon the iEHR IE Core Data for Interoperability (IECDI) requirements, vaccine codes are required.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Systems SHOULD follow the Project IE@ Technical Specification for Patient Addresses Final Version 1.0 as the standard style guide for
Location.address.line
andLocation.address.city
.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | address | string | |
SHALL | name | string | |
SHOULD | address-city | string | |
SHOULD | address-postalcode | string | |
SHOULD | address-state | string |
resolves
read
, vread
.create
, search-type
, update
, patch
, delete
, history-instance
, history-type
.The Media Resource is a Must Suppot referenced resource when using the IE Core DiagnosticReport Profile for Report and Note Exchange.
resolves
read
.vread
, history-instance
.create
, search-type
, update
, patch
, delete
, history-type
.
- The MedicationRequest resource can represent a medication, using an external reference to a Medication resource. If an external Medication Resource is used in a MedicationRequest, then the READ SHALL be supported.
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- The MedicationDispense resources can represent a medication using either a code or refer to the Medication resource. When referencing Medication, the resource may be contained or an external resource. The server application MAY choose any one way or more than one method, but if an external reference to Medication is used, the server SHALL support the _include` parameter for searching this element. The client application must support all methods.
- For example, A server SHALL be capable of returning dispense records for all medications for a patient using one of or both:
GET /MedicationDispense?patient=[id]
GET /MedicationDispense?patient=[id]&_include=MedicationDispense:medication
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | type | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
The MedicationRequest resources can represent a medication using either a code or refer to the Medication resource. When referencing Medication, the resource may be contained or an external resource. The server application MAY choose any one way or more than one method, but if an external reference to Medication is used, the server SHALL support the _include` parameter for searching this element. The client application must support all methods.
- For example, A server SHALL be capable of returning all medications for a patient using one of or both:
GET /MedicationRequest?patient=[id]
GET /MedicationRequest?patient=[id]&_include=MedicationRequest:medication
The MedicationRequest resource can represent that information is from a secondary source using either a boolean flag or reference in
MedicationRequest.reportedBoolean
, or a reference usingMedicationRequest.reportedReference
to Practitioner or other resource.
- Although both are marked as must support, the server systems are not required to support both a boolean and a reference, but SHALL choose to support at least one of these elements.
- The client application SHALL support both elements.
When recording “self-prescribed” medication, requester SHOULD be used to indicate the Patient or RelatedPerson as the prescriber. (See the Medication List section for guidance on accessing a patient medications including over the counter (OTC) medication and other substances taken for medical and recreational use.)
The MedicationRequest resource can communicate the reason or indication for treatment using either a code in MedicationRequest.reasonCode or a reference using MedicationRequest.reasonReference.
Although both
MedicationRequest.reasonCode
andMedicationRequest.reasonReference
are marked as Additional IECDI Requirements. The certifying server system is not required to support both but SHALL support at least one of these elements. The certifying client application SHALL support both elements.
- when using MedicationRequest.reasonReference:
- Servers SHALL support at least one target resource in
MedicationRequest.reasonReference
. Clients SHALL support all target resources.- The referenced resources SHOULD be a IE Core Profile as documented in Referencing IE Core Profiles.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
MAY | authoredon | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | encounter | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | intent | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.IE Core Laboratory Result Observation Profile
IE Core Observation Pregnancy Status Profile
IE Core Observation Pregnancy Intent Profile
IE Core Observation Occupation Profile
IE Core Respiratory Rate Profile
IE Core Simple Observation Profile
IE Core Treatment Intervention Preference Profile
IE Core Care Experience Preference Profile
IE Core Heart Rate Profile
IE Core Body Temperature Profile
IE Core Pediatric Weight for Height Observation Profile
IE Core Pulse Oximetry Profile
IE Core Smoking Status Observation Profile
IE Core Observation Sexual Orientation Profile
IE Core Head Circumference Profile
IE Core Body Height Profile
IE Core BMI Profile
IE Core Observation Screening Assessment Profile
IE Core Average Blood Pressure Profile
IE Core Blood Pressure Profile
IE Core Observation Clinical Result Profile
IE Core Pediatric BMI for Age Observation Profile
IE Core Pediatric Head Occipital Frontal Circumference Percentile Profile
IE Core Body Weight Profile
IE Core Vital Signs Profile
- Systems SHOULD support
Observation.effectivePeriod
to accurately represent tests that are collected over a period of time (for example, a 24-Hour Urine Collection test).- An Observation without a value, SHALL include a reason why the data is absent unless there are component observations, or references to other Observations that are grouped within it
- Systems that never provide an observation without a value are not required to support
Observation.dataAbsentReason
- An
Observation.component
without a value, SHALL include a reason why the data is absent.
- Systems that never provide an component observation without a component value are not required to support
Observation.component.dataAbsentReason
.- When
Observation.category
is "laboratory" the encounter, Updates to Meta.lastUpdated SHOULD reflect:
- New laboratory results
- Changes in the status of laboratory results including events that trigger the same status (e.g., amended → amended).
Conformance | Parameter | Type | Documentation |
---|---|---|---|
MAY | category | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | code | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | _lastUpdated | date | A server SHALL document the types of changes that can be detected using this parameter. A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
Conformance | Parameters | Types |
---|---|---|
SHALL | patient+code | reference +token |
SHALL | patient+category+date | reference +token +date |
SHALL | patient+category | reference +token |
SHOULD | patient+code+date | reference +token +date |
SHOULD | patient+category+status | reference +token +token |
SHOULD | patient+category+_lastUpdated | reference +token +date |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Systems SHALL support National Provider Identifier (NPI) for organizations and SHOULD support Clinical Laboratory Improvement Amendments (CLIA) identifiers for
Organization.Identifier
.- Systems SHOULD follow the Project IE@ Technical Specification for Patient Addresses Final Version 1.0 as the standard style guide for
Organization.address.line
andOrganization.address.city
.
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
For IECDI requirements, each Patient must support the following additional elements. These elements are included in the formal definition of the profile. The patient examples include all of these elements.
- contact detail (e.g. a telephone number or an email address)
- a communication language
- an ethnicity
- previous name
- Previous name is represented by providing an end date in the
Patient.name.period
element for a previous name.- suffix
- Suffix is represented using the
Patient.name.suffix
element.The Patient's Social Security Numbers (i.e. PPS) SHOULD NOT be used as a patient identifier in
Patient.identifier.value
.Although Patient.deceased[x] is marked as 𝗔𝗗𝗗𝗜𝗧𝗜𝗢𝗡𝗔𝗟 𝗜𝗘𝗖𝗗𝗜, certifying systems are not required to support both choices, but SHALL support at least
Patient.deceasedDateTime
.Certifying systems SHALL and non-certifying systems SHOULD follow the Project IE@ Technical Specification for Patient Addresses Final Version 1.0 as the standard style guide for
Patient.address.line
andPatient.address.city
for new and updated records.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | |
SHALL | identifier | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
SHALL | name | string | |
MAY | birthdate | date | A client SHALL provide a value precise to the day. A server SHALL support a value a value precise to the day. |
MAY | death-date | date | A client SHALL provide a value precise to the day. A server SHALL support a value a value precise to the day. |
MAY | family | string | A server SHALL support a value precise to the day. |
MAY | gender | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | given | string |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Servers that support only IE Core Practitioner Profile SHALL provide implementation specific guidance how to access a provider’s location and contact information using only the Practitioner resource.
- Although Practitioner.address is marked as Must Support, the server system is not required to support it if they support the IE Core PractitionerRole Profile, but SHALL support it if they do not support the IE Core PractitionerRole Profile. The client application SHALL support both.
- Systems SHOULD follow the Project IE@ Technical Specification for Patient Addresses Final Version 1.0 as the standard style guide for
Practitioner.address.line
andPractitioner.address.city
.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | identifier | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
SHALL | name | string | |
SHOULD | _id | token |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Due to implementer feedback, some IE Core Profiles reference the PractitionerRole resource instead of the IE Core PractitionerRole Profile. However the IE Core PractitionerRole Profile SHOULD be used as the default profile if referenced by another IE Core profile.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | practitioner | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
SHALL | specialty | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Procedure codes can be taken from SNOMED-CT, CPT, HCPCS II, ICD-10-PCS, CDT. LOINC.
- Only LOINC concepts that reflect actual procedures SHOULD be used
- A procedure including an implantable device SHOULD use
Procedure.focalDevice
with a reference to the IE Core Implantable Device Profile.- Servers and Clients SHALL support both IE Core ServiceRequest and IE Core Procedure Profiles for communicating the reason or justification for a referral as Additional IECDI Requirements. Typically, the reason or justification for a referral or consultation is communicated through
Procedure.basedOn
linking the Procedure to the IE Core ServiceRequest Profile that includes eitherServiceRequest.reasonCode
orServiceRequest.reasonReference
. When the Procedure does not have an associated ServiceRequest, it is communicated through the IE Core Procedure Profile'sProcedure.reasonCode
orProcedure.reasonReference
. Depending on the procedure being documented, a server will select the appropriate Profile to use.
- Although both
Procedure.reasonCode
andProcedure.reasonReference
are marked as Additional IECDI Requirements. The certifying server system is not required to support both but SHALL support at least one of these elements. The certifying client application SHALL support both elements.
- when using
Procedure.reasonReference
:
- Servers SHALL support at least one target resource in
Procedure.reasonReference
. Clients SHALL support all target resources .- The referenced resources SHOULD be a IE Core Profile.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | code | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | date | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
.vread
, history-instance
.create
, search-type
, update
, patch
, delete
, history-type
.
- The IE Core Provenance resource SHALL be supported for these IE Core resources:
- AllergyIntolerance
- CarePlan
- CareTeam
- Condition
- Coverage
- Device
- DiagnosticReport
- DocumentReference
- Encounter
- Goal
- Immunization
- MedicationDispense
- MedicationRequest
- Observation
- Patient
- Procedure
- QuestionnaireResponse
- RelatedPerson
- ServiceRequest
- If a system receives a provider in
Provenance.agent.who
as free text they must capture who sent them the information as the organization. On request they SHALL provide this organization as the source and MAY include the free text provider.- Systems that need to know the activity has occurred SHOULD populate the activity.
read
, vread
.create
, search-type
, update
, patch
, delete
, history-instance
, history-type
.
IE Core defines two ways to represent the questions and responses to screening and assessment instruments:
- Observation: IE Core Observation Screening Assessment Profile
- Questionnaire/QuestionnaireResponse: SDC Base Questionnaire/IE Core QuestionnaireResponse Profile
IE Core Servers SHALL support IE Core Observation Screening Assessment Profile and SHOULD support the SDC Base Questionnaire Profile/IE Core QuestionnaireResponse Profile
search-type
, read
, vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
IE Core defines two ways to represent the questions and responses to screening and assessment instruments:
- Observation: IE Core Observation Screening Assessment Profile
- Questionnaire/QuestionnaireResponse: SDC Base Questionnaire/IE Core QuestionnaireResponse Profile
IE Core Servers SHALL support IE Core Observation Screening Assessment Profile and SHOULD support the SDC Base Questionnaire Profile/IE Core QuestionnaireResponse Profile
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | |
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | authored | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | questionnaire | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
search-type
, read
.vread
, history-instance
.create
, update
, patch
, delete
, history-type
.
- Systems SHOULD follow the Project IE@ Technical Specification for Patient Addresses Final Version 1.0 as the standard style guide for
RelatedPerson.address.line
andRelatedPerson.address.city
.
resolves
read
.vread
, history-instance
.create
, search-type
, update
, patch
, delete
, history-type
.
- Servers and Clients SHALL support both IE Core ServiceRequest and IE Core Procedure Profiles for communicating the reason or justification for a referral as Additional IECDI Requirements. Typically, the reason or justification for a referral or consultation is communicated through
Procedure.basedOn
linking the Procedure to the IE Core ServiceRequest Profile that includes eitherServiceRequest.reasonCode
orServiceRequest.reasonReference
. When the Procedure does not have an associated ServiceRequest, it is communicated through the IE Core Procedure Profile'sProcedure.reasonCode
orProcedure.reasonReference
. Depending on the procedure being documented, a server will select the appropriate Profile to use.
ServiceRequest.reasonCode
andServiceRequest.reasonReference
are marked as Additional IECDI Requirements. The certifying server system is not required to support both but SHALL support at least one of these elements. The certifying client application SHALL support both elements.
- when using
ServiceRequest.reasonReference
:
- Servers SHALL support at least one target resource in
ServiceRequest.reasonReference
. Clients SHALL support all target resources.- The referenced resources SHOULD be a IE Core Profile.
Conformance | Parameter | Type | Documentation |
---|---|---|---|
SHALL | _id | token | |
SHALL | patient | reference | The client SHALL provide at least a id value and MAY provide both the Type and id values. The server SHALL support both. |
MAY | authored | date | A client SHALL provide a value precise to the second + time offset. A server SHALL support a value precise to the second + time offset. |
MAY | category | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | code | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
MAY | status | token | The client SHALL provide at least a code value and MAY provide both the system and code values. The server SHALL support both. |
resolves
read
.vread
, history-instance
.create
, search-type
, update
, patch
, delete
, history-type
.
- Although both
Specimen.identifier
andSpecimen.accessionIdentifier
are marked as Must Support, the server system is not required to support both, but SHALL support at least one of these elements. The client application SHALL support both.
Conformance | Operation | Documentation |
---|---|---|
SHOULD | $expand | If a server supports DocumentReference for creating, using, and sharing clinical notes, it SHOULD also support the |