Import Balances (Reconciliation Compliance)

Imports balances data using Data Management from a previously created Data Load definition, and returns success or failure status.

When using Data Management, if a data load rule fails, the Account Reconciliation log file includes a message such as the following:

Dataload process failed for process {JOB_ID}. Check the Data Management log for more details.
Data Management log file name: {LOG_FILE_NAME}
Detailed error from Data Management process: {DETAILS}

Refer to the Data Management log file to understand the reason for the job failure. If multiple data load rules fail, a separate log is created for each data load rule.

REST Resource

POST       /armARCS/rest/{api_version}/jobs/

Required Roles

Service Administrator, Power User, User, Viewer

Users with Power User, User, and Viewer predefined roles may require additional application roles.

Request

Supported Media Types: application/json

Parameters

The following table summarizes the client request.

Table 17-17 IMPORT_BALANCES

Name	Description	Path	Required
api_version	Version of the API you are working with, such as v1	Yes	Yes
jobName	The name of the job, IMPORT_BALANCES	No	Yes
period	The name of the period, such as April 2016	No	Yes
dl_Definition	The name of a previously saved data load using the format DL_name.	No	Yes

Example of request body

{
  "jobName" : "IMPORT_BALANCES",
               "parameters": {
                              "period":"April 2016",
                              "dl_Definition":"DL_test"
                               }
}

Response

Supported Media Types: application/json

Parameters:

Table 17-18 Parameters

Name	Description
details	In case of errors, details are published with the error string
status	See Migration Status Codes
links	Detailed information about the link
href	Links to the API call
action	The HTTP call type
rel	Relationship type (self, Job Status). if set to Job Status, you can use the href to get the status of the operation
data	Parameters as key value pairs passed in the request

Example of Response Body

The following is an example of the response body in JSON format.

{
"type": "ARCS",
"status": -1,
"details": "In Process",
"links": [
{
"rel": "self",
"href": "https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/armARCS/rest/v1/jobs/2141
"action": "GET"
}
]
}