Update Unmatched Transactions (Transaction Matching)

Updates one or more editable attributes in an unmatched transaction.

REST Resource

POST       /arm/rest/{api_version}/dataSources/{dataSource}/transactions/{transaction}

Required Roles

Service Administrator, Power User, Preparer, or Profiles and Reconciliations - Manage

The user who created a profile can also unmatch transactions associated with that profile.

Request

Supported Media Types: application/json

Parameters

The following table summarizes the client request specific to this job.

Table 17-73 UPDATE UNMATCHED TRANSACTIONS

Name Description Type Required
api_version Version of the API you are working with: v1 Path Yes
dataSource Text ID of the data source associated with the unmatched transaction whose attributes must be updated Path Yes
transaction Transaction ID of the unmatched transaction whose attributes must be updated Path Yes
reconId Text Id of the reconciliation associated with the unmatched transaction that must be updated Payload Yes
attributeId Text Id of the attribute within the unmatched transaction that must be updated Payload Yes
calculate Set to one of the following values:
  • True - Values of calculated attributes are recalculated
  • False - Values of calculated attributes are left unchanged.

The default setting is False.

 Payload No
forceReopen

Valid values are:

  • True - Reconciliations will be reopened if the Adjustment Accounting Date is less than the Closed Through Date.
  • False - Matched transactions whose Adjustment Accounting Date is less than the Closed Through Date are skipped. This is the default setting.
 Payload No

Example URL

https://<SERVICE_NAME>-
<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/arm/rest/v1/dataSources/POS/transactions/1012

Example of request body

{
   "reconId": "INTERCO133",
   "attributeId": "POS_AMOUNT",
   "value": "210015.05",
   "calculate": false,
   "forceReopen": false
}

Response

Supported Media Types: application/json

Example of Response Body

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

{
    "type": "TM",
    "items": null,
    "error": null,
    "link": null,
    "status": 0,
    "details": "Success : Update transaction - 1012",
    "links": [
        {
            "rel": "self",
            "href":"https://<SERVICE_NAME>-<TENANT_NAME>.<SERVICE_TYPE>.<dcX>.oraclecloud.com/arm/rest/dataSources/POS/transactions/1012",
            "action": "GET",
            "data": null
        }
    ]
}