Employee

Namespace: urn:employees.lists.webservices.netsuite.com

Fields

NameTypeCardinalityLabelRequiredHelp
accountNumber string 0..1 Account F Sets the account number for the employee � this account number may be used by your company, payroll service or other benefits provider. This field is required for the Online Bill Pay feature.
accruedTimeList EmployeeAccruedTimeList 0..1
addressbookList EmployeeAddressbookList 0..1
adpId string 0..1
altName string 0..1 To update the internal ID of the Name field to altName, in the UI go to: 1. Setup > Company > Auto-Generated Numbers. 2. Enable auto-generated numbers for Employees, set Enable Override to TRUE, and then click Save. When you edit existing Employee records, the internal ID for the Name field becomes altName.
approvalLimit double 0..1 Expense Approval Limit F Sets the amount of the largest expense report this supervisor can approve.
approver RecordRef 0..1 Expense Approver F References an employee record. Sets the person who approves the employees expense reports and purchase requests. If you have set a supervisor, you can NOT set an approver. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
billingClass RecordRef 0..1 Billing Class F In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
billPay boolean 0..1 Enable Online Bill Pay F Check this box in order to send this employee payments online. You cannot use this feature for paychecks. You must follow the set up procedures at <_TABNAME=ADMI_XML_PAYTRUST_SETUP_> > <_TASKCATEGORY=ADMI_XML_PAYTRUST_SETUP_> > Online Bill Pay before you can use this feature.
birthDate dateTime 0..1 Birth Date F Enter the employee's date of birth.
class RecordRef 0..1 References a value from a user defined list at Setup > Company > Classifications > Classes. This field is required when the Make Classes Mandatory preference is enabled at Setup > Accounting > Accounting Preferences. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
comments string 0..1 Notes F Enter other information you want to track for this employee.
commissionPaymentPreference EmployeeCommissionPaymentPreference 0..1 Pay Commissions Using F Select in the dropdown whether the payor for this employee's commissions always should be Payroll, always should be Accounts Payable, or should vary according to preferences set in the NetSuite system.
companyContributionList EmployeeCompanyContributionList 0..1
concurrentWebServicesUser boolean 0..1 Concurrent Web Services User F This field appears only if the Web services feature is enabled in NetSuite.
currency RecordRef 0..1 Currency F The currency for an employee automatically defaults to the base currency of the associated subsidiary or company. This currency must be used for transactions with this employee.
customFieldList CustomFieldList 0..1
customForm RecordRef 0..1 Custom Form T References an existing custom form for this record type. To ensure that field relationships defined within a desired custom form are maintained, you must provide the customForm value. Also, if defaults are off, then customForm is required, if defaults are on then the default form is used. Internal ID values for existing forms can be found at Setup > Customization > Entry Forms. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
dateCreated dateTime 0..1 Date Created F When adding a record, this field defaults to the current system date and time. This field cannot be overwritten. The default value is set regardless of any use default settings.
deductionList EmployeeDeductionList 0..1
defaultAddress string 0..1 Address F This field displays in text format the employee's address, as entered in fields on the Address subtab.
department RecordRef 0..1 References a value from a user defined list at Setup > Company > Departments. This field is required when Make Departments Mandatory is enabled at Setup > Accounting > Accounting Preferences. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
directDeposit boolean 0..1 Direct Deposit Participant F Check this box to use Direct Deposit for transferring funds to an employee's bank account. Direct Deposit transactions take place over the Internet and in real time. These transactions have immediate accounting impact on your books. Payments you transmit are withdrawn from your company's bank account.
directDepositList EmployeeDirectDepositList 0..1
earningList EmployeeEarningList 0..1
eligibleForCommission boolean 0..1 Eligible for Commission F Check the box to indicate this employee can be paid commission.
email string 0..1 Email F Sets the employee's e-mail address.
emergencyContactList EmployeeEmergencyContactList 0..1
employeeStatus RecordRef 0..1 Employee Status F References a value in a user defined list at Setup > Accounting > Setup Tasks > Employee Related Lists > Employee Status. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
employeeType RecordRef 0..1 Type F References a value in a user defined list at Setup > Accounting > Setup Tasks > Employee Related Lists. This value sets the type of employee for tax reporting purposes. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
entityId string 0..1 If the Auto box is not checked, manually enter an ID for this record. If the Auto box is checked, NetSuite assigns an ID for this record based on your settings at <_TABNAME=ADMI_NUMBERING_> > <_TASKCATEGORY=ADMI_NUMBERING_> > Auto-Generated Numbers.
ethnicity RecordRef 0..1 Ethnicity F Select the employee's ethnicity. You can create a new ethnicity category at <_TABNAME=EDIT_EMPOTHERLIST_> > <_TASKCATEGORY=EDIT_EMPOTHERLIST_> > Employee Related Lists.
expenseLimit double 0..1 Expense Limit F In the Expense Limit field, enter the amount this employee can expense without approval from a supervisor or approver.
fax string 0..1 Fax F Enter a fax number for this record. You should enter the fax number exactly as it must be dialed. If a '1' is required to fax to this number, be sure to include it at the beginning of the number. The number you enter here automatically appears in the To Be Faxed field of transactions when you select this customer. To fax NetSuite forms, an administrator must first set up fax service at <_TABNAME=ADMI_PRINTING_> > <_TASKCATEGORY=ADMI_PRINTING_> > Printing, Fax & Email Preferences.
firstName string 0..1 First Name F Required for Online Bill pay feature.
gender Gender 0..1 Gender F Select the employee's gender.
giveAccess boolean 0..1 Login Access F Check this box to give your employee access to NetSuite. Then, set a role to customize the level of access using the EmployeeRolesList field. You must also assign a password and e-mail address for the employee to log in.
globalSubscriptionStatus GlobalSubscriptionStatus 0..1 Email recipients can have one of four subscription statuses: * Confirmed Opt-In - When an email recipient has indicated that they want to receive your campaign messages, they are assigned this subscription status. Only a recipient can set his or her subscription status to Confirmed Opt-In. * Soft Opt-In - Recipients with this status can receive opt-in messages that enable them to confirm whether or not they want to receive your email campaigns as well as email marketing campaigns. You can set a recipient&#x2019;s status to Soft Opt-In manually or through a mass update. * Soft Opt-Out - Recipients with this status cannot receive campaign email messages but can receive opt-in messages. You can change this subscription status to Soft Opt-In manually or through a mass update. * Confirmed Opt-Out - Only the recipient can set their subscription status to Confirmed Opt-Out. Recipients with this status cannot receive email campaigns or opt-in messages. Recipients with this status can only opt in again through the Employee Center or by clicking the link in a campaign message they have received prior to opting out.
hasOfflineAccess boolean 0..1 Offline Client Access F If set to True, the user is granted offline access privileges. The Offline Client for Sales feature must be enabled and your account must be provisioned for Offline Client for Sales in order for this field to be settable.
hireDate dateTime 0..1 Hire Date T Enter the date this employee was hired.
homePhone string 0..1 Home Phone F Enter this employee's home phone number here.
hrEducationList EmployeeHrEducationList 0..1
image RecordRef 0..1 Image F References an image file that has already been uploaded to the account. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
inheritIPRules boolean 0..1 Inherit Allowed IP Addresses from Company T Check this box to allow this employee NetSuite login access at the IP addresses listed at Setup > Company Information. If you check this box, this employee has access to NetSuite at every company conputer with access unless you specify an IP address(es) in the IP Address Restriction field. If you do not check this box, you must enter an IP Address where this employee can log in in the field below, or this employee will not be able to log in to NetSuite.
initials string 0..1 Initials F NetSuite automatically completes this field as you enter first, middle and last names. If you want to make changes to an employee's initials, enter up to three letters in this field.
IPAddressRule string 0..1 Extra Allowed IP Addresses T Enter the IP address(es) where you want this employee to have access in the following formats: 1. A dotted decimal IP address such as 123.456.78.90 2. A range of IP addresses entered in dotted decimal with a dash and no spaces between such as 123.45.567.8-123.45.568.9 3. A list of IP address separated by spaces or commas such as 123.456.78.90, 123.546.768.97, . . . 4. An IP address and mask, such as 209.209.48.32/255.255.0.0. 5. The text "ALL" -- allows all IP addresses You can enter up to 1024 characters. If you do not enter an IP Address here, you must check the Inherit IP Rules from Company box, or this employee will no longer be able to log in to NetSuite.
isInactive boolean 0..1 This field is false by default.
isJobResource boolean 0..1 Job Resource F Set this field to TRUE so that this employee can be added as a resource on projects and tasks. Note that if this field is set to TRUE, the Work Calendar (workCalendar) field becomes a mandatory field.
isSalesRep boolean 0..1 Sales Rep F Sets the employee as a Sales Rep.
isSupportRep boolean 0..1 Support Rep F Sets the employee as a Support Rep.
jobDescription string 0..1 Job Description F Enter a description of the duties related to the job this person currently performs.
laborCost double 0..1 Labor Cost F Enter the employee's hourly overhead labor rate. This rate is used to calculate the estimated cost of jobs this employee works on.
lastModifiedDate dateTime 0..1 Last Modified Date F
lastName string 0..1 Last Name F Enter the employee's last name here. What you enter here automatically appears last in the Employee field. The first letter of what you enter here appears in the Initials field. This field is required for the Online Bill Pay feature.
lastPaidDate dateTime 0..1 Last Paid Date F Sets the last day this employee was paid. NetSuite automatically updates this whenever a new paycheck is generated.
lastReviewDate dateTime 0..1 Last Review Date F Enter the date of this person's last salary evaluation.
location RecordRef 0..1 References a value in a user-defined list at Setup > Company > Classifications > Locations. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
maritalStatus RecordRef 0..1 Marital Status F Select the employee's marital status. You can create a new marital status at <_TABNAME=EDIT_EMPOTHERLIST_> > <_TASKCATEGORY=EDIT_EMPOTHERLIST_> > Employee Related Lists.
middleName string 0..1 Enter a middle name or initial here. What you enter here automatically appears second in the Employee field. The first letter of what you enter here appears in the Initials field. Enter up to 25 characters in this field.
mobilePhone string 0..1 Mobile Phone F Phone numbers can be entered in the following formats:999-999-9999, 1-999-999-9999, (999) 999-9999, 1(999) 999-9999 or 999-999-9999 ext 9999
nextReviewDate dateTime 0..1 Next Review Date F Enter the date of this person's next salary evaluation.
officePhone string 0..1 Office Phone F Phone numbers can be entered in the following formats:999-999-9999, 1-999-999-9999, (999) 999-9999, 1(999) 999-9999 or 999-999-9999 ext 9999
password string 0..1 Password F Password must be no more than 16 characters long and must contain one number or special character. Special characters include: , ` ~ ! @ # $ % ^ & * ) ; ' [ ] "{ }. If this user has multiple accounts, you can NOT submit a new password on an update. If attempted, the request will succeed but the password is not changed in the database.
password2 string 0..1 Confirm Password F This field must match the value entered in password.
payFrequency EmployeePayFrequency 0..1 Pay Frequency T References a value in a system list.
phone string 0..1 Phone F
phoneticName string 0..1 Enter the furigana character you want to use to sort this record.
purchaseOrderApprovalLimit double 0..1 Purchase Approval Limit F In the Purchase Approval Limit field, enter the maximum amount an employee is allowed to approve on a purchase request when specified as an approver for an employee.
purchaseOrderApprover RecordRef 0..1 Purchase Approver F In the Purchase Approver field, select the person that approves the employee&#x2019;s purchase requests. If no approver is selected, the supervisor approves purchase requests. If a purchase approver is selected, the supervisor is no longer part of the approval hierarchy.
purchaseOrderLimit double 0..1 Purchase Limit F In the Purchase Limit field, enter the amount this employee can purchase without approval from a supervisor or approver.
ratesList EmployeeRatesList 0..1
releaseDate dateTime 0..1 Release Date{:date an employee leaves the company} F Sets the last date of employment
requirePwdChange boolean 0..1 Require Password Change On Next Login F If set to TRUE, the employee is required to change the default password assign on the next login attempt.
rolesList EmployeeRolesList 0..1
salesRole RecordRef 0..1 Sales Role F Note that the Team Selling feature must be turned ON for this field to be available.
salutation string 0..1 Mr./Ms... F Enter the employee's salutation, such as Mr. or Ms., here.
sendEmail boolean 0..1 Send Notification Email F If set to True, an e-mail notification is automatically sent to this employee informing them of access privileges to NetSuite. Note that for security, the e-mail message does not disclose the password. You have to contact your employee with this information.
socialSecurityNumber string 0..1 Sets the employee's social security number. Must be of the following format: 123-45-6789.
subscriptionsList EmployeeSubscriptionsList 0..1
subsidiary RecordRef 0..1 Select the subsidiary to associate with this employee. You cannot enter transactions for this employee unless a subsidiary is assigned. If you select this employee on time transactions, the transaction is associated with this subsidiary. The employee is able to access only information associated with this subsidiary. Note: Once a transaction has posted for the employee, you are not able to change the subsidiary selected on the employee record.
supervisor RecordRef 0..1 Supervisor F References an employee record. This employee will approve expense reports and purchase requests. In order to retrieve a list of available values for this field, use the GetSelectValue operation. For more information, see getSelectValue of the Platform Guide.
template RecordRef 0..1 Template F Use templates to enter data for employees quickly. To set up employee record templates, go to <_TABNAME=EDIT_EMPLOYEE_> > <_TASKCATEGORY=EDITEMPLOYEE_> > Employees, and click New Template.
timeApprover RecordRef 0..1 Time Approver F In the Time Approver field, select the person who approves the employee&#x2019;s time transactions. If no time approver is selected, the employee&#x2019;s supervisor approves time entries. If both a supervisor and a time approver are selected, then only the time approver can approve time entries using their Employee Center role.
title string 0..1 Job Title F Enter this employee's official job title here.
usePerquest boolean 0..1 Include in US Payroll F Check this box if you want to include this employee in your pay runs. This employee will also be included in the Employee list on payroll forms and reports.
useTimeData EmployeeUseTimeData 0..1 Use Time Data F If enabled, the employee is paid for hours entered in NetSuite time transactions.
workCalendar RecordRef 0..1 Work Calendar T This field is mandatory if the Job Resource (isJobResource) field is set to TRUE.
workplace RecordRef 0..1 Workplace F Select the workplace where this employee works. The address of this workplace will be used to define the taxes you are required to withhold and pay for this employee.

Attributes

NameType
externalId string
internalId string

Related Searches

Name
EmployeeSearch
EmployeeSearchAdvanced
EmployeeSearchBasic
EmployeeSearchRow
EmployeeSearchRowBasic