NetSuite RESTInstall

Summary

Create a NetSuite Time Bill from an Employee by sending a POST request to the transform endpoint, optionally mapping fields such as date, hours and linked records.

Inputs

• id (required) — Internal identifier of the employee to transform.
• isDebugMode — Include full request and response details in the output.
• additionalFields.caseTaskEvent.id — Internal identifier for the related Case Task Event.
• additionalFields.caseTaskEvent.externalId — External identifier for the related Case Task Event.
• additionalFields.class.id — Internal identifier of the Class to associate with the Time Bill.
• additionalFields.class.externalId — External identifier of the Class to associate with the Time Bill.
• additionalFields.customForm.id — Internal identifier of the custom form to use.
• additionalFields.customForm.refName — Reference name of the custom form.
• additionalFields.customer.id — Internal identifier of the Customer being billed.
• additionalFields.customer.externalId — External identifier of the Customer being billed.
• additionalFields.tranDate — Date of the time bill transaction.
• additionalFields.department.id — Internal identifier of the Department.
• additionalFields.department.externalId — External identifier of the Department.
• additionalFields.hours — Duration of the time bill in hours and minutes.
• additionalFields.employee.id — Internal identifier of the Employee working the time.
• additionalFields.employee.externalId — External identifier of the Employee working the time.
• additionalFields.externalId — External identifier for the generated Time Bill.
• additionalFields.item.id — Internal identifier of the Item related to the Time Bill.
• additionalFields.item.externalId — External identifier of the Item related to the Time Bill.
• additionalFields.lastModifiedDate — Last modified date of the Time Bill.
• additionalFields.location.id — Internal identifier of the Location.
• additionalFields.location.externalId — External identifier of the Location.
• additionalFields.overrideRate — Lock the rate entered so it is not affected by future rate changes.
• additionalFields.memo — Memo or note for the Time Bill.
• additionalFields.payrollWorkplace.id — Internal identifier of the Payroll Workplace.
• additionalFields.payrollWorkplace.externalId — External identifier of the Payroll Workplace.
• additionalFields.Prefer — Server behavior request (e.g., 'respond-async').
• additionalFields.price.id — Internal identifier of the Price Level.
• additionalFields.price.externalId — External identifier of the Price Level.
• additionalFields.rate — Explicit rate to charge for the time.
• additionalFields.refName — Reference name for display.
• additionalFields.replace — Comma‑separated sublist names to replace.
• additionalFields.subsidiary.id — Internal identifier of the Subsidiary.
• additionalFields.subsidiary.externalId — External identifier of the Subsidiary.
• additionalFields.displayField — Last time tracking info for the user.
• additionalFields.X-NetSuite-Idempotency-Key — Idempotency key for asynchronous requests.
• additionalFields.X-NetSuite-PropertyNameValidation — Strictness level for property name validation.
• additionalFields.X-NetSuite-PropertyValueValidation — Strictness level for property value validation.

Output shape

a NetSuite Time Bill record (JSON object)

If Debug Mode is enabled the output contains additional request/response details. Otherwise only the created Time Bill fields are returned.

Examples

Example 1: Create a simple time bill for an employee

"id": 123, "additionalFields": {"tranDate": "2023-08-30", "hours": "8", "employee": {"id": "123"}}

Example 2: Create a time bill linked to a customer and department

"id": 123, "additionalFields": {"customer": {"id": "456"}, "department": {"id": "789"}, "hours": "4", "employee": {"id": "123"}}

Example 3: Create a time bill with debug and asynchronous preference

"id": 123, "isDebugMode": true, "additionalFields": {"Prefer": "respond-async", "hours": "6", "employee": {"id": "123"}}