Finance and Insurance Service (FAIS)
1.0.0-current - ci-build International flag

Finance and Insurance Service (FAIS), published by IHE IT Infrastructure Technical Committee. This guide is not an authorized publication; it is the continuous build for version 1.0.0-current built by the FHIR (HL7® FHIR® Standard) CI Build. This version is based on the current content of https://github.com/IHE/ITI.Finance/ and changes regularly. See the Directory of published versions

2:3.123 Check Enrollment Status [ITI-123]

This section corresponds to transaction [ITI-123] of the IHE IT Infrastructure Technical Framework. Transaction [ITI-123] is used by the Beneficiary Manager and Beneficiary Requestor Actors. The Check Enrollment Status [ITI-123] transaction is used to get the status of an enrollment request by searching for EnrollmentResponse resources.

2:3.123.1 Scope

This transaction is used by the Beneficiary Requestor to get the status of an enrollment request from an EnrollmentResponse resource based on criteria it provides in the query parameters of the request message, or to retrieve a specific EnrollmentResponse. The request is received by the Beneficiary Manager. The Beneficiary Manager processes the request and returns a response of the matching response resources.

2:3.123.2 Actors Roles

Table 2:3.123.2-1: Actor Roles

Actor Role
Beneficiary Requestor Requests EnrollmentResponse(s) matching the supplied set of criteria from the Beneficiary Manager.
Beneficiary Manager Returns information for EnrollmentResponse(s) matching the criteria provided by the Beneficiary Requestor

2:3.123.3 Referenced Standards

2:3.123.4 Messages

Beneficiary RequestorBeneficiary Manager[1]Search Enrollment Response Request:HTTP GET <Base>/EnrollmentResponse?<Parameters>[2]Search Enrollment Response Response:Bundle[4]Read Enrollment Response Request:HTTP GET <Base>/EnrollmentResponse/<ResourceId>[5]Read Enrollment Response Response:EnrollmentResponse
Figure 2:3.123.4-1: Interaction Diagram


2:3.123.4.1 Search Enrollment Response Request Message

The Search Enrollment Response message is a FHIR search interaction on the EnrollmentResponse Resource.

2:3.123.4.1.1 Trigger Events

A Beneficiary Requestor triggers a Search Enrollment Response Request to a Beneficiary Manager according to the business rules for the search. These business rules are outside the scope of this transaction.

2:3.123.4.1.2 Message Semantics

A Beneficiary Requestor initiates a search interaction using HTTP GET as defined at http://hl7.org/fhir/R4/http.html#search on the EnrollmentResponse resource. The query parameters are identified below. A Beneficiary Requestor MAY query any combination or subset of the parameters. The target is formatted as:

GET [base]/EnrollmentResponse?[parameter=value]

Where [base] is the URL of Beneficiary Manager.

A Beneficiary Manager SHALL support responding to a request for both the JSON and the XML messaging formats as defined in FHIR. A Beneficiary Requestor SHALL accept either the JSON or the XML messaging formats as defined in FHIR. See ITI TF-2: Appendix Z.6 for more details.

A Beneficiary Manager SHALL implement the parameters described below. A Beneficiary Manager MAY choose to support additional query parameters beyond the subset listed below. Any additional query parameters supported SHALL be supported according to the core FHIR specification.

See ITI TF-2: Appendix W for informative implementation material for this transaction.

2:3.123.4.1.2.1 Query Parameters

The Beneficiary Manager will support the search parameters as defined in the capability statement for EnrollmentResponse.

The Beneficiary Requestor will support the search parameters as defined in the capability statement for EnrollmentResponse.

2:3.123.4.1.3 Expected Actions

The Beneficiary Manager SHALL process the query to retrieve the enrollment response(s) that match the search parameters given, and if successful, with an HTTP 200 (OK) and a Search Enrollment Response Response Message or an error as per http://hl7.org/fhir/R4/search.html#errors.

2:3.123.4.2 Search Enrollment Response Response Message

2:3.123.4.2.1 Trigger Events

The Beneficiary Manager found Enrollment Responses matching the query parameters specified by the Beneficiary Requestor as a result of a Search Enrollment Response Request.

2:3.123.4.2.2 Message Semantics

The Beneficiary Manager SHALL support the search response message as defined at http://hl7.org/fhir/R4/http.html#search on the EnrollmentResponse, as defined at http://hl7.org/fhir/R4/enrollmentresponse.html.

The “content-type” of the response will depend upon the requested response format indicated by the Beneficiary Requestor.

See ITI TF-2: Appendix Z.6 for more details on response format handling. See ITI TF-2: Appendix Z.7 for handling guidance for Access Denied.

2:3.123.4.2.2.1 FHIR EnrollmentResponse Resource Constraints

A EnrollmentResponse Resource returned by the Beneficiary Manager SHALL be further constrained as described in the FAIS EnrollmentResponse profile.

2:3.123.4.2.3 Expected Actions

The Beneficiary Requestor has received the response and continues with its workflow.

2:3.123.4.3 Read Enrollment Response Request Message

This message represents an HTTP GET from the Beneficiary Requestor to the Beneficiary Manager and provides a mechanism for retrieving a single EnrollmentResponse with a known resource id.

2:3.123.4.3.1 Trigger Events

When the Beneficiary Requestor possesses the id of EnrollmentResponse (either through query, database lookup, or other mechanism) for which it requires additional or new information, it issues a Read Enrollment Response Request.

2:3.123.4.3.2 Message Semantics

A Beneficiary Requestor initiates a read interaction using HTTP GET as defined at http://hl7.org/fhir/R4/http.html#read on the EnrollmentResponse Resource. The target is formatted as:

GET [base]/EnrollmentResponse/[resourceId]

Where [base] is the URL of Beneficiary Manager.

The resourceId included in the request always represents the unique id for the EnrollmentResponse within the scope of the URL. For example, while http://example1.org/ihe/EnrollmentResponse/1 and http://example2.com/ihe/EnrollmentResponse/1 both contain the same [resourceId], they reference two different resource instances.

Note: The use of “http” or “https” in URL does not override requirements to use TLS for security purposes.

A Beneficiary Manager SHALL support responding to a request for both the JSON and the XML messaging formats as defined in FHIR. A Beneficiary Requestor SHALL accept either the JSON or the XML messaging formats as defined in FHIR. See ITI TF-2: Appendix Z.6 for more details.

See ITI TF-2: Appendix W for informative implementation material for this transaction.

2:3.123.4.3.3 Expected Actions

The Beneficiary Manager SHALL process the request to retrieve the EnrollmentResponse that matches the given resource id, and if successful, with an HTTP 200 (OK) and a response as defined at http://hl7.org/fhir/R4/http.html#read with the Read Enrollment Response Response Message or an error code as defined at http://hl7.org/fhir/R4/http.html#Status-Codes.

2:3.123.4.4 Read Enrollment Response Response Message

2:3.123.4.4.1 Trigger Events

The Beneficiary Manager found a EnrollmentResponse Resource matching the resource identifier specified by the Beneficiary Requestor.

2:3.123.4.4.2 Message Semantics

The Read Enrollment Response Response is sent from the Beneficiary Manager to the Beneficiary Requestor as a single EnrollmentResponse, as defined at http://hl7.org/fhir/R4/enrollmentresponse.html and constrained by the FAIS EnrollmentResponse profile.

The “content-type” of the response will depend upon the requested response format indicated by the Beneficiary Requestor.

See ITI TF-2: Appendix Z.6 for more details on response format handling. See ITI TF-2: Appendix Z.7 for handling guidance for Access Denied.

2:3.123.4.4.3 Expected Actions

The Beneficiary Requestor has received the response and continues with its workflow.

2:3.122.5 CapabilityStatement Resource

Server implementing this transaction SHALL provide a CapabilityStatement Resource as described in ITI TF-2x: Appendix Z.3 indicating the transaction has been implemented.

2:3.123.6 Security Considerations

See FAIS Security Considerations

2:3.123.6.1 Security Audit Considerations

Note that the same audit message is recorded by both the Beneficiary Requestor and Beneficiary Manager. The difference being the Audit Source element. Both sides record to show consistency between the message sent by the Beneficiary Requestor and the action taken at the Beneficiary Manager.

The actors performing the Check Enrollment Status Query message SHALL record audit events according to the Audit Event for Check Enrollment Status Query Transaction. See Audit Example for Check Enrollment Status search from the Beneficiary Manager.

The actors performing the Check Enrollment Status Read message SHALL record audit events according to the Audit Event for Check Enrollment Status Read Transaction. See Audit Example for Check Enrollment Status read message from the Beneficiary Requestor.