NetSuite SuiteTalk icon

NetSuite SuiteTalk

NetSuite REST API

Batch Update Records

AI-generated

Summary

Update multiple NetSuite records asynchronously in batches up to 100 items per job, optionally waiting for each batch job to complete and returning per-record success or failure results.

Inputs

  • Record Type (required) — Select the type of NetSuite records to update (e.g., Sales Order, Customer, Invoice). If 'Custom Record' is chosen, specify the Custom Record Script ID.
  • Custom Record Script ID (required) — The internal identifier for the Custom Record type, required if using 'Custom Record' as Record Type.
  • ID (Per Item) (required) — Record identifier for each input item, supporting expressions to specify different records. Prefix with 'eid:' to use external ID instead of internal ID.
  • Wait For Results — If true, wait until all batch jobs complete and output one result per input item; if false, output one item per submitted job with job ID only.
  • Batch Options — Options for the batch job submit, including idempotency key to avoid duplicates, parallel processing mode, polling interval for status checks, and timeout for job completion.
  • Options — Miscellaneous options including returning full response data and maximum retry attempts on rate limits or server errors.

Output shape

A list of JSON items correlating to each input record if 'Wait For Results' is enabled, each indicating success or failure, or a list of job submission results with job IDs if disabled.

Input items are grouped into jobs of up to 100 records each. When 'Wait For Results' is false (default), results contain job submission info but not per-record outcomes. When true, the node waits for each job's completion, polling NetSuite based on configured interval and timeout, then outputs one result per record processed. Errors include message details. The 'internalId' field supports mixed use of internal and external identifiers (prefixed by 'eid:').

Examples

Example 1: Batch update multiple sales order records providing their IDs and update data in workflow input.

Set 'Record Type' to 'Sales Order'; for each input item, supply the record 'ID (Per Item)' and JSON data with updates; optionally enable 'Wait For Results' to receive individual record results.

Links

Discussion