submit()

Submits a transaction for approval.

Syntax

            SubmitResult[] submitResults = stub.submit(new SubmitRequest[] submitRequests); 

          

Usage

Use the submit() command to submit transactions such as bookings, expense reports, invoices, or timesheets for approval. The maximum number of objects you can submit with one single call is 1,000.

For information about object types for which the XML API and SOAP API support approval-related operations, see Approval-Related Operations.

Arguments

Name

Type

Description

submitRequests

SubmitRequest[]

Array of SubmitRequest objects

Response

SubmitResult[] — Array of SubmitResult objects.

Sample Code — C#

            // submit an envelope for approval
oaEnvelope env = new oaEnvelope();
env.id = "122";

oaApproval appr = new oaApproval();
appr.cc = "help@ddd.com"; // cc approval email to additional contacts
appr.notes = "Approval notes";

SubmitRequest sr = new SubmitRequest();
sr.submit = env;
sr.approval = appr;

SubmitResult[] results = _svc.submit(new SubmitRequest[] { sr }); 

          

Sample Code — Java

            // submit an envelope for approval
oaEnvelope env = new oaEnvelope();
env.setId("122");
oaApproval appr = new oaApproval();
appr.setCc("help@ddd.com"); // cc approval email to additional
contacts
appr.setNotes("approval notes");
SubmitRequest sub = new SubmitRequest();
sub.setApproval(appr);
sub.setSubmit( env );

SubmitResult[] results = stub.submit(new SubmitRequest[] { sub });