Get a file status and metric details
/api/erp/integrations/resources/v1/{locale}/files/{id}
Request
-
id(required): string
The unique identifier of the file.Example:
324108415901929470
-
locale(required): string
The locale to which the file is being uploaded.Example:
en-us
-
flowName: string
The name of the flow for which the service is being invoked.
-
userType: string
For internal use only.
There's no request body for this operation.
Back to TopResponse
- application/json
Default Response
object
-
currentStage: string
Indicates the current stage.
-
dateFormatUsed: string
The date format specified for the uploaded file.
-
elapsedTime: string
The time elapsed since the file was uploaded for processing.
-
fileId: string
The unique identifier of the file.
-
flowName: string
The name of the flow for which the service is being invoked.
-
lastStatusTime: string
The time when the status was last fetched.
-
stages: object
StageChild
-
status: string
The overall processing status of the uploaded file.
-
uploadedBy: string
The user who uploaded the file.
-
uploadedTime: string
The date and time when the file was uploaded.
object
-
dataflowStartUpTIme: string
-
elapsedTime: string
-
endTime: string
-
errorHeaderCount: integer
(int64)
-
errorLineCount: integer
(int64)
-
errors: string
-
exceptions: string
-
name: string
-
processInitStartTime: string
-
sparkJobTime: string
-
startTime: string
-
status: string
-
successHeaderCount: integer
(int64)
-
successLineCount: integer
(int64)
-
totalHeaderCount: integer
(int64)
-
totalLineCount: integer
(int64)
Examples
To retrieve the processing status and monitor the progress of an Accounting Hub Transaction file which was uploaded., use this GET REST operation. The response includes details such as transaction data file name, uploaded by and upload time, number of transaction header and line records in each file.
The feedback includes detailed information of the file followed by a summary for each processing stage. The main section contains information about the transaction data file including file name, when it was uploaded, by whom, date format used, as well as transaction headers and lines count.
If some of the transactions have not been processed yet, the transaction counts are subject to change as it indicates only what have been processed so far. Below the main section are information for each of the stages. The Data Validation Stage verifies the data integrity of the file. For example, whether the data file contains at least a metadata file and a header file.
The Transaction Stage verifies the transaction data complies with the business rules for Accounting Hub flow. For example, it ensures the ledger name is valid and transaction date has been provided. The last stage is the Post Processing Stage which includes generating accounting and posting into General Ledger. For each stage, the Response Output includes Start and End Time, Elapsed Time which indicates the time taken for the different stages, error messages if any, and suggested actions to resolve them. Processed and Invalid record counts are also returned for the Transaction Stage along with a hyperlink to review additional details. If the Post Processing stage was initiated but didn’t complete successfully, it also includes a hyperlink to retrieve additional details.
Example URL
Here's an example of the resource URL:
GET
/api/erp/integrations/resources/v1/{locale}/files/{id}
cURL Command
curl --location 'https://servername.fa.us2.oraclecloud.com/api/erp/integrations/resources/v1/en-us/files/481756702644670464?flowName=fah-import' \
--header 'Authorization: Bearer <Bearer Token>
Example Response
Here's an example of the response body in JSON format:
{
"fileId":"98715717449060352",
"flowName":"fah-import",
"status":"Accounted",
"dateFormat":"YYYY-MM-DD",
"uploadedTime": "2021-12-02T07:53:21.499111Z",
"uploadedBy": "Finuser1",
"lastStatusTime": "2022-02-02T01:07:37.604529Z",
"elapsedTime": 687,
"currentStage*": "Post Process",
"totalHeaderCount": 2,
"successHeaderCount": 2,
"errorHeaderCount": 0,
"totalLineCount": 2,
"successLineCount": 2,
"errorLineCount": 0,
"inProcessingCount":0,
"stages":{
"inboundData":{
"name": "Inbound Data",
"startTime": "2022-02-02T00:56:09.984994Z",
"endTime": "2022-02-02T00:59:35.681360Z",
"elapsedTime": "3min 25sec",
"status": "SUCCEEDED",
"errors": <REFERENCE TO Inbound Data Errors API> - 3a
"exceptions":<REFERENCE TO Inbound Data Exceptions API> - 4
},
"transaction":{
"name": "Transaction",
"startTime": "2022-02-02T00:59:58.949058Z",
"endTime": "2022-02-02 01:06:58.401",
"elapsedTime": "6min 59sec",
"status": "SUCCEEDED",
"totalHeaderCount": 2,
"successHeaderCount": 2,
"errorHeaderCount": 0,
"totalLineCount": 2,
"successLineCount": 2,
"errorLineCount": 0,
"errors": <REFERENCE TO Inbound Data Errors API> - 3a
"exceptions": <REFERENCE TO Inbound Transaction Exceptions API> - 4
},
"postProcess": {
"name": "Post Process",
"startTime": "2022-02-02T00:56:09.984994Z",
"endTime": "2022-02-02T00:59:35.681360Z",
"elapsedTime": "3min 25sec",
"status": "SUCCEEDED "
"subStages": <REFERENCE TO Post Process API> -3c
"errors": <REFERENCE TO Inbound Post Process Exceptions API>
"exceptions": <REFERENCE TO Inbound Post Process Exceptions API> - 4
}
}
}