Execute a Processing Action for All Filtered Records

A processing form contains selection criteria, a table with the filtered records (the records that meet the selection criteria), and two main buttons that are usually named Process and Process All. You execute the Process All command by using the contract-based REST API in two stages:

1. You run a request to retrieve the records for processing that meet the desired selection criteria (see Narrow the List of Records on a Processing Form).
2. In the body of the second request, you use the id value from the response that you received in the first stage to execute the Process All command, which affects all filtered records. (This topic provides information on the corresponding action.)

HTTP Method and URL

You click Process All on the form toolbar of a processing form to process all records contained in the table of this form. To process all listed records by using the contract-based REST API, you use the POST HTTP method and the following URL.

http://<Base endpoint URL>/<Top-level entity>/<Process All action name>

For example, suppose that you want to execute the Process All command of the Emails Pending Processing (SM507000) form in a local MYOB Acumatica instance with the name AcumaticaDB by using the system endpoint with the name Default and Version 23.200.001. You should use the following URL to execute the Process command.

http://localhost/AcumaticaDB/entity/Default/23.200.001/EmailProcessing/ProcessAllEmailProcessing

Parameters

You use no parameters when you execute an action.

Request Headers

You can specify the following headers in the request.

Request Body

As a request body, you create a JSON object with the only Entity key; as the value, you use the key-value pair with the id key that is taken from the response body received when the selection criteria were applied (see Narrow the List of Records on a Processing Form).

Response Status Codes

The following table lists the HTTP status codes that the system returns for a request that performs an action.

"CustomerID": {
 "value": "ABARTENDE1",
 "error": "'Customer' cannot be found in the system."
}

Example

For example, suppose that you want to process all incoming and outgoing pending emails assigned to the current user in an MYOB Acumatica instance. On the UI, the Emails Pending Processing (SM507000) form can be used for this purpose. This form is mapped to the EmailProcessing entity, which has the ProcessAllEmailProcessing action; this action corresponds to the Process All button.

Following is an example of a request that processes all the pending emails that are retrieved in the example provided in Narrow the List of Records on a Processing Form.

POST /ProcessAllEmailProcessing HTTP/1.1
Host: [<MYOB Acumatica instance URL>]/entity/Default/23.200.001/EmailProcessing
Accept: application/json
Content-Type: application/json

{
    "Entity": {"id": "e269bafb-a6c0-4463-a3ad-e8b3eab203d4"}
}