NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Fulfillment Request → Insert or update record

AI-generated

Summary

Create or modify a NetSuite Fulfillment Request by sending a PUT request to its REST endpoint, providing an external identifier and any fields to set or replace.

Inputs

  • id (required) — External identifier of the fulfillment request to create or update. Must be supplied when performing the PUT request.
  • isDebugMode — If true, the node outputs the full HTTP request and response along with the parsed NetSuite object.
  • additionalFields — Collection of standard NetSuite fields (e.g., entity, status, items, dates etc.) that will be sent in the request body. All sub‑fields are optional.'
  • customFields — Optional list of custom fields to include in the request body. Each field requires a field name, type, and value matching the NetSuite definition.
  • Prefer — Header to request asynchronous processing. Choose "respond-async" to obtain a status location instead of the full record.
  • X-NetSuite-Idempotency-Key — Optional unique key for idempotency when the request is executed asynchronously.
  • X-NetSuite-PropertyNameValidation — Optional header controlling strictness of property name validation (Error, Warning, Ignore).

Output shape

a single object representing the server response; when debug mode is on, the output includes the raw request and response details in addition to the parsed object.

The object contains the updated or created Fulfillment Request record fields. API may return minimal data if the resource is not found or if permission restrictions apply. When the Prefer header is used, the response will be a status or location URL instead of the full record.

Examples

Example 1: Create a new fulfillment request

Set isDebugMode true, id "fulfill-123", entity internal id "123", status internal id "2", add one item line with internal id "234" and quantity 10.

Example 2: Update an existing fulfillment request asynchronously

Set id "fulfill-123", Prefer "respond-async", include updated memo and replace items list.

Example 3: Add a custom string field to a fulfillment request

Set id "fulfill-123", customFields include fieldName "priority", fieldType "String", value "High".

Discussion