Points to Consider
Consider these key points when performing fixed assets REST operations:
- The capabilities and processing logic for these operations are similar to that of tasks in the Fusion Assets Cloud.
- You must specify the correct endpoint before preforming the REST operation.
- Validation messages in the response payload are limited to the first 1000 characters.
- Changes to fixed assets are automatically and immediately saved.
- Requests are fully validated prior to processing.
- The only supported date format for fixed assets REST payloads is YYYY-MM-DD.
- Successful outcomes are confirmed by a response payload with the value
'S'forX_RETURN_STATUS.
cURL Command
curl -i -u "<username>:<password>" -H "Content-Type: application/vnd.oracle.adf.resourceitem+json" -X POST -d <payload> https://servername.fa.us2.oraclecloud.com/fscmRestApi/resources/11.13.18.05/erpintegrations
Request Payload Structure
Here are some key points associated with the request payload of the fixed assets REST operations:
- The request payload requires only two attributes,
OperationNameandParameterList. - The
OperationNameparameter value follows this format:"ProcessTransaction-<handle>" - The
ParameterListparameter value lists the details of your parameters in JSON format. - Parameters ending in
_TBLare special Rosetta type values. Rosetta formats capture hierarchical information succinctly. Rosetta type values must be separated by commas and the number of values per each type of parameter must be kept consistent. - Attributes specified in the request payload as
ParameterListmust be in uppercase and correctly spelled. Incorrect attributes are ignored. - Specify only parameter values that are not null in the
ParameterList. Any parameter that is not in theParameterListwill be initialized to null by default. - The HTTP method is always
POST. - The endpoint is always
/fscmRestApi/resources/11.13.18.05/erpintegrations.
Here is the request payload structure for fixed assets REST operations:
{
"OperationName": "processTransaction-<handle>",
"ParameterList": "{Parameter1:value1,Parameter2:value2, Parameter3: value3,…,ParameterN: valueN}"
}
Response Payload Structure
Here are some key points associated with the response payload of the fixed assets REST operations:
ParameterListhas a different structure from the request payload in JSON format.OperationNameparameter value matches the request payload and follows the following format:"ProcessTransaction-<handle>".
Here is the response payload structure for fixed assets REST operations:
{
"OperationName": "processTransaction-<handle>",
"DocumentId": null,
"DocumentContent": null,
"FileName": null,
"ContentType": null,
"FileType": null,
"DocumentAccount": null,
"Comments": null,
"ProcessName": null,
"LoadRequestId": null,
"JobPackageName": null,
"JobDefName": null,
"ReqstId": null,
"RequestStatus": null,
"JobName": null,
"ParameterList": "Output parameter1: Value1, Output Parameter2: Value2, …, Output ParameterN: Value N",
"NotificationCode": null,
"CallbackURL": null,
"JobOptions": null,
"StatusCode": null,
"ESSParameters": null,
"links": [...]
}