Policy Enrollment Event Integration Point

The policy enrollment event integration point is intended for the creation of policy enrollment events that do not originate from Policies processing. Examples are policy enrollment events that are a result of a change in membership data not received through a Policy In Integration Point request but that can have an impact on the premium.

Request Message

The HTTP POST request to: http://[hostName]:[portNumber]/[api-context-root]/policyenrollmentevents enable external systems to create Policy Enrollment Events. Each request message contains a list of policy enrollment events in the context of a Policy.

Policy code is used as a pass parameter to the request.

The system accepts the request in the following format:

{
    "policyEnrollmentEventList": [
        {
            "personCode": "",
            "descr": "",
            "businessEventDefinitionCode": "",
            "value0": "",
            "value1": "",
            "value2": "",
            "value3": "",
            "value4": "",
            "value5": "",
            "value6": "",
            "value7": "",
            "value8": "",
            "value9": ""
        }
    ]
}

Only Policy enrollment events of type Message (M) or Business (B) can be created by means of this integration point.

If a business event definition code is provided in the payload, the system creates a policy enrollment event of type Business. If the business event definition code is not part of the payload, the system creates a policy enrollment event of type Message.

Response Message

The Oracle Health Insurance application creates the response messages in response to request messages it receives from external interfaces. Please refer to the "Response Messages" section in the HTTP API/IP Concepts as part of the Developer Guide for more details.

The response does not include a representation of the newly created resources.

Authorization

The operation is protected by the access restriction 'policyenrollmentevents IP'. If the access to the policy that the enrollment event belongs to is restricted by a data access group restriction, then to perform this operation on that policy enrollment event also a grant for that data access group restriction must be provided with the update flag set.

All person related policy enrollment events are subject to the access restrictions defined for the person that is retrieved in the GET request.

Error Messages

The following error messages that are specific to the Policy Enrollment Event integration point may return as part of the response messages:

Code	Severity	Message
POL-IP-PEEV-001	Fatal	Policy code {code} is unknown
POL-IP-PEEV-002	Fatal	Person code {code} is unknown
POL-IP-PEEV-003	Fatal	Business event definition code {code} is unknown