Get Leave Requests

The get leave request function returns a list of leave requests filtered by the supplied parameters. The request accepts the following parameters:

Leave requests matching the criteria parameters will be returned as an array, containing the following data for each leave request

The following is an example of a request and a successful response.

{
 "action": "function",
 "function" : "getleaverequests" 
 }

{
 "success":true,
 "data":[{
	"id":"1250",
	"name":"LEAVEREQ1250",
	"employee":"41",
	"leavetype":"21",
	"startdate":"2011-12-25",
	"enddate":"2012-01-06",
	"requiredhours":15.2,
	"status": "PENDING",
	"lastmodified":"21/4/2012 2:25 PM",
	"days":[
		{
			"hours": 7.6
			"trandate": "2016-08-02"
			"leavetype": "21"
		},
		{
			"hours": 7.6
			"trandate": "2016-08-03"
			"leavetype": "21"
		}
	]}
}

Updating a Leave Request

The status of a leave request can be updated by making an updateleaverequest function call for each leave request. In addition to updating the status the request can optionally update the hours required on each day as long as the total required hours is less than the original required hours.

The update leave request takes the following parameters:

The following is an example of a request and successful response.

{
  "action": "function",
  "function" : "updateleaverequest",
  "id" : "1608",
  "employee" : "41",
  "status" : "APPROVED"
}

{
"success": true
"id": "1608"
"processms": "1369"
}

Updating the Required Hours For A Leave Request

In addition to changing the status of the leave request, if the actual hours required for the period of leave have changed the optional "days" parameter can be supplied. A change of required hours will only be accepted if the total required hours is the same or less than the original request. When the optional days parameter is included the following fields will be updated on the NetSuite leave request:

• Required Hours (set to the total of the hours specified on each day)
• Start Date (will be set to the earliest day date)
• End Date (will be set to the latest day date)

In the following example the leave request has been approved but as the employee is only rostered to work 4.5 hours on the first day the original required hours for the first day is updated to 4.5 (Note: The days specified replaces the existing day data).

{
  "action": "function",
  "function" : "updateleaverequest",
  "id" : "1608",
  "employee" : "41",
  "status" : "APPROVED",
  "days":[
		{
			"hours": 4.5
			"trandate": "2016-08-02"
		},
		{
			"hours": 7.6
			"trandate": "2016-08-03"
		}
	]}
}

{
"success": true
"id": "1608"
"processms": "1369"
}

Error Codes

The following error codes can be returned from the leave requests functions.

TBC

Leave Request Status List

The status of a leave request when returned in the getLeaveRequests or set with the updateLeaveRequest function should be set to the Name of the status listed in the table below.