Working with the Approvals System
Submitting Booking, Timesheets, Envelopes, and Invoices
Submit open or rejected bookings, timesheets, envelopes, and invoices which you have rights to in OpenAir by creating an approval object, preparing the record for submission, defining an array of submit requests, and passing the requests to the NSOA.wsapi.submit(submitRequest) function.
submitRequest
The NSOA.wsapi.submit(submitRequest) function takes an array of up to 1000 submitRequest objects. Each submitRequest object contains an oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object to submit and additional approval process information passed to an oaApproval object.
// Define the submit requests
var requests = [{
submit: objectToProcess,
attributes [], // attributes only apply when submitting timesheets
approval: approvalObj
}];
Property |
Allowed Values |
submit |
oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object |
attributes |
Only accepts “submit_warning” for oaTimesheet |
approval |
oaApproval |
Approving Bookings, Timesheets, Envelopes, and Invoices
Approve submitted bookings, timesheets, envelopes, and invoices to which you have rights to in OpenAir by creating an approval object, preparing the record for approval, defining an array of approve requests, and passing the requests to the NSOA.wsapi.approve(approveRequest) function.
approveRequest
The NSOA.wsapi.approve(approveRequest) function takes an array of up to 1000 approveRequest objects. Each approveRequest object contains an oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object to approve and additional approval process information passed to an oaApproval object.
// Define the approve requests
var requests = [{
approve: objectToProcess,
attributes [], // pass an empty array for attributes when using approveRequest
approval: approvalObj
}];
Property |
Allowed Values |
approve |
oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object |
attributes |
Pass an empty array |
approval |
oaApproval |
Rejecting Bookings, Timesheets, Envelopes, and Invoices
rejectRequest
The NSOA.wsapi.reject(rejectRequest) function takes an array of up to 1,000 rejectRequest objects. Each rejectRequest object contains an oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object to submit and additional approval process information passed to an oaApproval object. The rejectRequest object is used to specify the required data to return in the NSOA.wsapi.reject(rejectRequest) function.
// Define the reject requests
var requests = [{
reject: objectToProcess,
attributes [], // pass an empty array for attributes when using rejectRequest
approval: approvalObj
}];
Property |
Allowed Values |
reject |
oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object |
attributes |
Pass an empty array |
approval |
oaApproval |
Unapproving Bookings, Timesheets, Envelopes, and Invoices
The NSOA.wsapi.unapprove(unapproveRequest) function takes an array of up to 1,000 unapproveRequest objects. Each unapproveRequest object contains an oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object to unapprove and additional approval process information passed to an oaApproval object. The unapproveRequest object is used to specify the required data to return in the NSOA.wsapi.unapprove(unapproveRequest) function.
unapproveRequest
The unapproveRequest object is used to specify the required data to return in the NSOA.wsapi.unapprove(unapproveRequest) function.
// Define the unapprove requests
var requests = [{
unapprove: objectToProcess,
attributes [], // pass an empty array for attributes when using unapproveRequest
approval: approvalObj
}];
Property |
Allowed Values |
unapprove |
oaBooking, oaTimesheet, oaEnvelope, or oaInvoice object |
attributes |
Pass an empty array |
approval |
oaApproval |