NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Cash Refund → Update record

AI-generated

Summary

Update an existing Cash Refund record in NetSuite using its internal identifier.

Inputs

  • Id (required) — The internal identifier of the Cash Refund record to update.
  • Additional Fields — Modify standard fields on the Cash Refund, such as account, billing/shipping addresses, currency, department, discount details, associated entity, items, location, memo, and various payment-related information.
  • Custom Fields — Provide values for custom fields configured in your NetSuite instance for Cash Refund records. Each custom field requires its name, type, and the corresponding value.
  • Prefer — Specify 'respond-async' to execute the request asynchronously. The server will return 'Preference-applied: respond-async' if applied.
  • Replace — Provide a comma-separated list of sublist names whose existing lines will be entirely replaced by the lines specified in the request body. If a sublist name is provided but no corresponding lines are in the request, the sublist will be cleared.
  • Replace Selected Fields — If set to 'true', any body fields intended for deletion in the update request must be explicitly included in the 'replace' query parameter. (Note: The 'replace' query parameter is not exposed in the UI, but this description comes directly from the API schema.)
  • X-NetSuite-Idempotency-Key — A unique UUID to ensure that asynchronous requests are executed only once. This is ignored for synchronous requests.
  • X-NetSuite-PropertyNameValidation — Control the strictness of property name validation (Error, Warning, or Ignore).
  • X-NetSuite-PropertyValueValidation — Control the strictness of property value validation (Error, Warning, or Ignore).
  • Debug Mode — Include detailed request and response information in the output for debugging purposes.

Output shape

A single JSON object representing the updated Cash Refund record.

The returned object contains the fields that were successfully updated in NetSuite. Its structure mirrors the NetSuite REST API's response for a patch operation on a Cash Refund.

Examples

Example 1: Update the memo on an existing cash refund.

Set 'Id' to the refund's internal ID, then provide a new 'Memo' value under 'Additional Fields'.

Example 2: Adjust the date and add an item to a cash refund.

Specify the 'Id', then set 'Date' and add an item with its 'Item' identifier and 'Quantity' under 'Additional Fields'.

Example 3: Modify the billing address details and a custom boolean field for a cash refund.

Provide the 'Id', update 'Billing Address' fields (e.g., 'City', 'State'), and set the 'Field Name' and 'Value' for a boolean 'Custom Field'.

Discussion