Employee Change Request

Important:

This topic describes a feature that is currently available only in some customer accounts. For information about the availability of this feature for your account, please contact your NetSuite account manager.

Employee Change Requests allow managers to initiate requests for changes to their employees in NetSuite. Employee change request types must be set up and assigned to an employee change reason. Managers can initiate an employee change request for their direct reports in the Employee Center and have it go through an approval process which you can define in SuiteFlow. Approvers can approve or decline employee change requests and approved requests will be reflected in the employee's record on a proposed future date. For more information about employee change requests, see Employee Change Requests.

The internal ID for this record is employeechangerequest.

See the SuiteScript Records Browser for all internal IDs associated with this record.

Note:

For information about using the SuiteScript Records Browser, see Working with the SuiteScript Records Browser in the NetSuite Help Center.

For information about scripting with this record in SuiteScript, see the following help topics:

• SuiteScript 2.x Scripting Records and Subrecords

• N/record Module

Prerequisites

To use the employee change request record, you must enable and set up the Employee Change Requests, Effective Dating, and Advanced Employee Permissions features at Setup > Company > Enable Features, on the Employees tab. To create an employee change request approval workflow in SuiteFlow, you must also enable the SuiteFlow feature at Setup > Company > Enable Features, on the SuiteCloud tab.

Supported Script Types

The employee change request record is scriptable in both client and server SuiteScript.

Field IDs

Field Label	Internal ID	Type
Justification	justification	text
Requester	requester	select
Proposed Date	proposeddate	date
Next Approver	nextapprover	select
Request Status	requeststatus	select
Inactive	isinactive	checkbox
Change Type	employeechangerequesttype	select
Declining Reason	decliningreason	text
Declined By	declinedby	select

Supported Functions

The following SuiteScript functionality is supported:

• Read

• Create

• Update

• Delete

• Search

Copy and transform are not supported.

Usage Notes

The following fields cannot be edited and are only available on create:

• requester

• employee

• <requested fields>

Code Samples

Note:

The proposeddate field syntax must match the format you have chosen in your company settings. Go to Setup > Company > Preferences > General Preferences to configure your Date Format.

The following sample shows how to create an employee change request.

          require(['N/record'], function(record){
    var empChangeReq = record.create({
        type : record.Type.EMPLOYEE_CHANGE_REQUEST
    });
    empChangeReq.setValue({
        fieldId : 'employeechangerequesttype',
        value: '1'
    });
    empChangeReq.setText({
        fieldId : 'proposeddate',
        text: '10/10/2020'
    });
    empChangeReq.setValue({
        fieldId : 'justification',
        value: 'Justification'
    });
    empChangeReq.setValue({
        fieldId : 'employee',
        value: '854'
    });
    empChangeReq.save(); 
}); 

        

Related Topics

Employee Change Requests

SuiteCloud Supported Records

Lists

General Notices