With this API, you can submit approval requests asynchronously. This API accepts the object type and the object ID of the context object as input parameters. 

APISignature
submitForApprovalsAsyncWebService static Boolean submitForApprovalsAsync(String sObjectType, ID sObjectId);
Request Parameters
NameTypeRequired?Description

approvalObjectId

IDYesID of the approval context object.

approvalObjectType

StringYesType of the approval context object.
Response Parameter
NameTypeDescription
resultBooleanReturns true if the API is executed successfully.
/**
 *  Apttus Approvals Management
 *  TestSubmitAsyncAPISample
 *   
 *  @2020 Apttus Inc. All rights reserved.
 */
public with sharing class TestSubmitAsyncAPISample {
	
	/**
	 * Class Constructor
	 */
	public TestSubmitAsyncAPISample() {

	}
	
	// test webservice API calls by running as anonymous apex from developer console
	//TestSubmitAsyncAPISample.TestSubmitForApprovalsAsync('Apttus__APTS_Agreement__c','a07R000000AiYQX');
 
	/**
	 * Submit an approvals process asynchronously
	 * @param sObjectType the approval context sobject type 
	 * @param sObjectId the approval context sobject identifier
	 * @return true if successful
	 */
	public static void TestSubmitForApprovalsAsync(String sObjectType, ID sObjectId) {
		
		// call API to submit async
		Boolean ok = Apttus_Approval.ApprovalsWebService.SubmitForApprovalsAsync(sObjectType, sObjectId);
		system.assertEquals(ok, true);
		
	}

}
CODE

Integration Details

Use the following information in your integrations with Apttus Intelligent Workflow Approvals API. Refer to Integrating Apttus with External Systems for information on how to get started.

API Prerequisites

None.

Response/Request XML

Example Request

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:app="http://soap.sforce.com/schemas/class/Apttus_Approval/ApprovalsWebService">
   <soapenv:Header>
      <app:SessionHeader>
         <sessionId>00DR0000001nyVR!ARYAQDLDaz7Bw9IfDVuVTeyiZwGL.4Oc2G8tgKIoJo0EEw9vlWQVnlEawyHu5UcIu.AUay3cBSoNFGd8OtrxX.D7yjqBK9SL</sessionId>
      </app:SessionHeader>
   </soapenv:Header>
   <soapenv:Body>
      <app:submitForApprovalsAsync>
         <app:sObjectType>Apttus__APTS_Agreement__c</app:sObjectType>
         <app:sObjectId>a07R000000AiYQX</app:sObjectId>
      </app:submitForApprovalsAsync>
   </soapenv:Body>
</soapenv:Envelope>
XML

Example Response

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns="http://soap.sforce.com/schemas/class/Apttus_Approval/ApprovalsWebService">
   <soapenv:Body>
      <submitForApprovalsAsyncResponse>
         <result>true</result>
      </submitForApprovalsAsyncResponse>
   </soapenv:Body>
</soapenv:Envelope>
XML