Overview

The following list provides an overview of the integration points that are available for exchanging data with Policies. The list is sorted in alphabetical order.

Click the triangle in front of the name of the integration point to reveal available operations.
Click the name of the integration point to go to the description page of the integration point.
Access Tokens

POST

/accesstokens/accesstoken retrieves an OAuth2 access token.

POST

/accesstokens/newaccesstoken retrieves a new OAuth2 access token.

POST

/accesstokens/anticsrftoken retrieves an anticsrf token.

Activities

POST

/activities creates an activity but does not start it.

POST

/activities/start creates and starts an activity.

POST

/activities/{activityId}/start starts the previously-created activity.

POST

/activities/{activityId}/recover recovers the failed activity.

GET

/activities/{activityId} retrieves the status of the activity.

GET

/activities/{activityId}/messages retrieves the result messages of an activity.

Oracle Health Insurance supports a generic activities API and a specific activities API.

The generic activities API supports the standard generic operations.
Oracle Health Insurance also supports generic APIs on

  • /generic/groupaccountactivities

  • /generic/basefinancialobjectactivities

  • /generic/groupclientactivities

  • /generic/financialtransactionsetactivities

  • /generic/policyactivities

  • /generic/connectorconfigurationactivities

  • /generic/globalactivities.

These are all subsets of the data returned by the generic /activities API.

Apply Registrations

POST

/applyregistrations creates a long running operation for apply registration

GET

/applyregistrations/{id} retrieves the apply registration long running operation

Banks

The generic banks API supports, in addition to the standard generic API operations, the GET and the PATCH operation on /generic/banks/key/{key}. This enables retrieving and updating a bank based on its code (the key).

Base Views

POST

/baseviews (re)generates base views

POST

/baseviews/\{view name}/regenerate (re)generates the base views

DELETE

/baseviews/\{view name} deletes the base views

This a long running operation through REST. See, "HTTP API/IP Concepts" chapter of the Developer Guide for more information on the general concepts of these operations.

This integration point can display PII data in an entity using the property ohi.baseview.exclude.pii.

A POST request on http://[hostName]:[portNumber]/[api-context-root]/generic/baseviews/search retrieves information about the generated base views.

Connector Configurations

POST

/connectorconfigurations/{id}/republishFailedMessages enables failed messages for republishing

Task Processing

GET

/tasksprocessing returns the status and statistics of the queue.

POST

/taskprocessing starts or stops the task queue.

GET

/tasksprocessing/{id}/restart restarts the task with this id.


The /generic/tasks API supports only search and retrieval operations.

Credentials

GET

/credentials retrieves an overview of the REST clients

GET

/credentials/{code} retrieves the credential with this code.

PUT

/credentials/{code} creates or updates the credential with this code.

DELETE

/credentials/{code} removes the credentials for the credential key with this code.

GET

/credentials/export extracts a JSON file with credentials stored in secret.

POST

/credentials/import uploads a JSON file with credentials to an application.

Data Sets

POST

/import/datasetdefinition/{datasetDefinitionCode}/dataset/{dataSetCode} starts the data exchange import process.

POST

/import/datasetdefinition/{datasetDefinitionCode} starts the data exchange import process.

GET

/export/datasetdefinition/{datasetDefinitionCode}/dataset/{dataSetCode} retrieves the data set content.

POST

/export/datasetdefinition/{datasetDefinitionCode}/dataset/{dataSetCode} starts the data exchange export process.

POST

/createandexport/datasetdefinition/{datasetDefinitionCode}/dataset starts the full config migration and export process.

PATCH

/dataset/{id} updates the selected config migration set based on operation.

PUT

/datasetdefinition/{datasetDefinitionCode}/dataset creates or updates the config migration and export process.

Data File Sets

GET

/datafilesets retrieves all data file sets in the system

POST

/datafilesets creates the data file set with data files

PUT

/datafilesets updates the data file set with data files

POST

/datafilesets#multipart creates the data file set and uploads the zip file to it

GET

/datafilesets/{datafilesetcode} retrieves the data file set

POST

/datafilesets/{datafilesetcode} adds the data file to the data file set

DELETE

/datafilesets/{datafilesetcode} deletes the data file set

GET

/datafilesets/{datafilesetcode}/zip retrieves the zip file of the data file set

POST

/datafilesets/{datafilesetcode}/zip adds the zip file to the data file set

PUT

/datafilesets/{datafilesetcode}/zip zips the contents of all data files in the data file set

PUT

/datafilesets/{datafilesetcode}/unzip unzips the contents of all data files in the data file set

PUT

/datafilesets/{datafilesetcode}/datafiles updates the data file in the data file set

DELETE

/datafilesets/{datafilesetcode}/datafiles/{datafilecode} deletes the data file from the data file set

GET

/datafilesets/{datafilesetcode}/datafiles/{datafilecode}/data retrieves the data file content

POST

/datafilesets/{datafilesetcode}/datafiles/{datafilecode}/data adds the data file content


The generic datafilesets API supports, in addition to the standard generic API operations, the GET and the PATCH operation on /generic/datafilesets/key/{key}. This enables retrieving and updating a datafileset based on its datafileset code.

Data Replication

GET

/replicationentities returns entities and their configuration.

GET

/replicationentities/{entity} returns configuration details of the specified entity.

PUT

/replicationentities/{entity} changes configuration of the specified entity.
Enables or disables change tracking on the specified entity.
Does not change any detail of the entity.
The integration point ignores requests for changes to any entity’s details.

GET

/replicationevents/{entity} returns the replication events that a source application logs for a specific entity.

Data Masking Configuration

POST

/deidentificationmetadata creates a new DeIdentification Metadata.

PUT

/deidentificationmetadata/{id} updates an existing DeIdentification Metadata

Dynamic Logic

GET

/dynamiclogicstatistics retrieves the different links to see the dynamic logic statistics.

GET

/dynamiclogicstatistics/{dynamicLogicCode} retrieves the dynamic logic statistics based on provided Dynamic Logic Code.

GET

/dynamiclogicstatistics/elapsed retrieves Dynamic Logic Statistic data sorted over total elapsed time.

GET

/dynamiclogicstatistics/executions retrieves Dynamic Logic Statistics data sorted over total number of dynamic logic executions.

GET

/dynamiclogicstatistics/allocatedmemory retrieves Dynamic Logic Statistics data sorted over over total memory allocated.

GET

/dynamiclogicstatistics/reset clears the cache for Dynamic Logic Statistics data.

POST

POST

/testdynamiclogic/{dynamicLogicCode} xx

Enrollment Files

POST

/enrollmentfiles/{id}/accept creates an accept enrollment file entity to start the accept enrollment file processing.

GET

/enrollmentfiles/{id}/accept fetches the accept enrollment file long running operation by id.

POST

/enrollmentfiles/{id}/reject creates a reject enrollment file entity to start the reject enrollment file processing.

GET

/enrollmentfiles/{id}/reject fetches a reject enrollment file entity to start the reject enrollment file processing.

GET

/enrollmentfiles/{id}/operationstatus fetches the last long running operation status performed on the enrolment file.

GET

/enrollmentfiles/{id}/status returns counts of statuses of policies of the update requests of an enrollment file.

GET

/enrollmentfiles/{id}/events returns counts of enrollment events per business event definition display text of an enrollment file".

Extract

POST

/extracts starts the extract process.`

GET

/extracts/{id} retrieves status information on the extract process.

Enrollment Status Response

GET

/enrollments inquires about a person or object, including the time window
and the line of business that the calling system is interested in.

Financial Messages

This integration point sends a notification message to an external system once the financial messages for a financial transaction set are written to the data file (see Generate Financial Message).
The financial message data file can be downloaded by using the "Get details of a data file" request from the Data File Sets.

Group Clients

PUT

/groupclients creates or updates a group client.

PUT

/groupclients/submit creates or updates a group client and submits for processing.

POST

/groupclients/{id}/submit submits the group client for processing.

POST

/groupclients/{id}/validate validates the group client for processing.

GET

/groupclients/{id} fetches a group client by id.

GET

/groupclients/{id}/status retrieves the status of the group client.

The generic group clients API supports, in addition to the standard generic API operations, the GET and the PATCH operation on /generic/groupclients/key/{key}. This enables retrieving and updating a group client based on its code.

Group Hierarchy

GET

/grouphierarchy/groupclient/{id} returns the upward grouphierarchy for the group client.

GET

/grouphierarchy/groupaccount/{id} returns the upward grouphierarchy for the group account.

GET

/grouphierarchy/groupaccountproduct/{id} returns the upward grouphierarchy for the group account product.

Key Stores

GET

/keystores/export exports keystore’s data from an older version of an application

POST

/keystores/import imports keystore’s data to the newer version of the application.

Macro Integration Point

POST

/macros invoke a macro.

Non-Entity Cache

POST

/nonentitycache/invalidateall invalidates all the no-entity caches.

Notes, Group Account Notes, Group Client Notes

POST

/notes/{subject} creates a note.

POST

/notes/{subject}/{id} creates a new version of the note.

GET

/generic/notes/{subject} retrieves all notes for the subject.

GET

/generic/notes/{subject}/search enables a search within the subject.

GET

/generic/notes/{subject}/{id} retrieves the specific note for the subject.

GET

/generic/notes/{subject}/{masterId}/audit retrieves all versions of the note.

Group Account Notes

POST

/groupaccountnotes/{subject} creates a note.

POST

/groupaccountnotes/{subject}/{id} creates a new version of the note.

Group Client Notes

POST

/groupclientnotes/{subject} creates a note.

POST

/groupclietnotes/{subject}/{id} creates a new version of the note.

OAuth2 Client Configuration

PUT

/{id}/setclientsecret cerates or updates the client secret.

Objects

GET

/objects/generate creates a zip file that is downloaded.

The following options are provided as query parameters to the above endpoint:

  • includeDynamicData

  • withSerialization

Organizations

PUT

/organizations creates or updates an organization.

GET

/organizations/{id} retrieves an organization by its ID.

In addition to the standard generic API operations, the generic organizations API supports the GET and the PATCH operations on /generic/organizations/key/{key}. This enables retrieving and updating an organization based on its code (the {key}).

Outbound Integration Points

GET

/outboundintegrationpoints retrieves the integration points with a configured endpoint.

Persons

PUT

/persons creates or updates a person.

GET

/persons/{id} retrieves a person by its id.

In addition to the standard generic API operations, the generic persons API supports the GET and the PATCH operations on /generic/persons/key/{key}. This enables retrieving and updating a person based on its code (the {\key}).

Policies

PUT

/policies creates or updates a policy.

PUT

/policies/submit creates or updates a policy and submits it for processing.

GET

/policies/{code}/attachedData fetches attached policy data on the policy.

PUT

/policies/{code}/attachedData updates attached policy data on the policy.

GET

/policies/{id} retrieves a policy by its unique identification.

POST

/policies/{id}/cancel provides the ability to cancel a policy.

POST

/policies/{id}/cancelwithinvoice provides the ability to cancel a policy and immediately produce an invoice for the cancelled policy.

GET

/policies/{id}/examplecalculation/{calculationInputDate} returns the calculations results of a policy valid on calculation input date, without storing the results of the calculation.

POST

/policies/{id}/fee generates fees and invoices for the policy.

POST

/policies/{id}/invoice calculates premium and creates invoices for the specified policy.

POST

/policies/{id}/mutation creates a mutation for a policy if it does not exist.

GET

/policies/{id}/nextcalculationcycles/{calculationInputDate} gets the information about next calculation cycles for a policy that uses policy calculation period based on premium calculation.

POST

/policies/{id}/processandapplyregistrations processes and applies registrations for a policy if applicable.

PUT

/policies/quote/{calculationInputDate} returns the calculations results of the policy request valid on calculation input date.

POST

/policies/{id}/revert reverts the policy.

POST

/policies/{id}/sampleinvoice calculates premium and creates invoices for the specified policy without persisting the results.

POST

/policies/{id}/sampleprocessandapplyregistrations sample processes and applies registrations for a policy if applicable.

GET

/policies/{id}/status returns the status of policy.

POST

/policies/{id}/submit submits a policy for processing.

POST

/policies/{id}/toedit brings the policy status to Edit.

POST

/policies/{id}/validate validates the policy

Policy Accounts

PUT

/policyaccounts creates or updates a policy account.

GET

/policyaccounts retrieves a policy account and its balance.

Policy Account Transactions

PUT

/policyaccounttransactions creates a policy account transaction.

GET

/policyaccounttransactions retrieves policy account transactions.

GET

/policyaccounttransactions/{id} retrieves the policy account transaction with this id.

The generic policy account transactions API supports, in addition to the standard generic API operations, the GET and the PATCH operation on /generic/policyaccounttransactions/key/{key}. This enables retrieving and updating a policy account transaction based on its authorization code (the {key}).

Policy Account Transaction List

This integration point creates policy account transactions from a data file. It requires sending in a data file and loading the file through the Load Policy Account Transactions activity.

Policy Enrollment Events

POST

/policyenrollmentevents creates one or more policy enrollment events.

Policy Update Request

PUT

/policyupdaterequests creates a policy update request with the payload of the Policy In Request.

PUT

/policyupdaterequests/{id}/apply applies a policy update request.

PUT

/policyupdaterequests/{id}/reject rejects a policy update request.

PUT

/policyupdaterequests/{id}/requeue re-queues a policy update request.

Properties

GET

/propertydefinitions returns system property definitions, including the relevant characteristics.

GET

/propertydefinitions?name=<prefix> returns the system property definitions, for which the name starts with the given prefix

GET

/propertydefinitions/<property> returns the system property definition, for which <property> is the exact name of the property

GET

/currentproperties returns all properties

GET

/currentproperties?name=<prefix> returns the properties for which the name starts with the given prefix

GET

/currentproperties/<property> returns the property for which <property> is the exact name of the property

Providers

Individual Providers

PUT

individualproviders creates an individual provider.

GET

individualproviders/{id}` retrieves the individual provider.

Organizational Providers

PUT

organizationalproviders creates an individual provider.

GET

organziationalproviders/{id} retrieves the organizational provider.

Providers

Individual Providers

PUT

individualproviders creates an individual provider.

GET

individualproviders/{id}` retrieves the individual provider.

Organizational Providers

PUT

organizationalproviders creates an individual provider.

GET

organziationalproviders/{id} retrieves the organizational provider.

Purge Policies
NOTE

The use of this resource in a production environment is strongly discouraged, as it may cause having financial messages in the system without the originating policies and policy changes.

POST

/purge/policies/id/{id} purges the policy.

POST

/purge/policies/code/{code} purges the policy.

Reference Sheet Lines

GET

/generic/referencesheetlines fetches the definition of the referencesheet resources including metadata and definition links for further details.

GET, PUT, DELETE, and PATCH

/generic/referencesheetlines/{reference-sheet-resource-name}/{id} support the standard functionality.

POST

/generic/referencesheetlines/{reference-sheet-resource-name}/search supports searching for reference sheet lines.

Registrations

The registration import is a long-running operation, a global activity which processes a data file.

Apply Registrations

POST

/applyregistrations creates the long running operation.

GET

/applyregistrations/{id} fetched=s the long-running operation

Process Registrations

POST

/processregistrations creates the long running operation.

GET

/processregistrations/{id} fetches the long-running operation

Relations

The generic relations API supports, in addition to the standard generic API operations, the GET operation on /generic/relations/{id} and /generic/relations/key/{key}. This enables retrieving a relation based on its id or on its code (the key).

Replication Entities

GET

/replicationentities returns an overview of the entities and their configuration details for which the system is able to track changes.

GET

/replicationentities/{entity} retrieves configuration details for a specific business entity

PUT

/replicationentities/{entity} update the configuration details for a specific business entity

Replication Events

GET

/replicationevents/{id} retrieves the replication events that the source system logged for the given entity.

Revert Policy

POST

/revertpolicies creates a revert policy entity to start the reversal of multiple policies.

GET

/revertpolicies/{id} fetches the revert policy long running operation by id

User Information

GET

http://[hostName]:[portNumber]/[api-context-root]/userinformation fetches the user information of the logged in user

`POST

http://[hostName]:[portNumber]/[api-context-root]/userinformation/userpreference updates the user preferences of the logged in user

User Provisioning

PUT

/users create or update a user

GET

/users/{loginName} retrieve the user

DELETE

/users/{loginName} delete the user

Workflow Event

The application sends out a "fire and forget" task event when a policy pends.
See Policy Workflow Integration Point (Fixed Payload) and Policy Workflow Integration Point (Configurable Payload).

Write Policies

POST

/writepolicies creates a write policy entity to start the fie processing.

GET

/writepolicies/{id} fetches import policy long running operation by id.

GET

/writepolicies/payload/definition fetches the structure of the file payload of policy import

Policy Update Requests

POST

/writepolicyupdaterequests creates a write policy update requestentity to start the fie processing.

GET

/writepolicyupdaterequests/{id} fetches the write policy update request long running operation by id.

GET

/writepolicyupdaterequests/payload/definition fetches the structure of the policy update request import