NetSuite REST Azerion icon

NetSuite REST Azerion

Call NetSuite SuiteTalk REST operations.

Actions981

Customer Refund → Insert record

AI-generated

Summary

Create a new customer refund record in NetSuite.

Inputs

  • total (required) — Refund amount. NetSuite updates this field as Apply boxes are checked or cleared at the bottom of the form.
  • externalId (required) — External identifier for the refund. Use to prevent duplicate processing.
  • memo — Optional memo describing the refund. Appears on issued checks and register reports.
  • tranDate — Date of the refund. NetSuite defaults to today; specify another date if needed.
  • apply — Sublist of transaction applications. Each item supports due, apply (boolean), createdFrom, currency, applyDate, doc, line, total, amount, refNum, refName, and type fields to apply the refund against specific transactions.
  • aracct — Accounting distribution detail with internal/external ID.
  • class — Transaction class with internal/external ID.
  • department — Department with internal/external ID.
  • location — Location with internal/external ID.
  • subsidiary — Subsidiary with internal/external ID.
  • customFields — List of custom fields to set on the refund. Multiple values allowed. Each entry requires a field name (loaded via loadCustomFields), field type (boolean, dateTime, multiSelect, number, select, string), and a value matching the type.
  • isDebugMode — Whether to include full request and response info in the output. Default: false.
  • X-NetSuite-Idempotency-Key — A user-defined unique idempotency key (RFC 4122 UUID format). Ensures the request executes only once. Ignored for synchronous requests.

Output shape

The created Customer Refund record with its internal ID and all populated fields returned from NetSuite. In n8n, the output item contains the record data for use in subsequent nodes.

If the apply sublist is populated, the refund is applied to the specified transactions, updating their outstanding balance and status. The customer's current balance is adjusted accordingly.

Examples

Example 1: Create a $500 refund for customer CUST-123 with a memo.

Set total to 500, externalId to a unique value (e.g., 'REFUND-001'), and memo to 'Refund for returned goods'. Leave tranDate default (today) and apply unspecified.

Links

Discussion