NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Inventory Transfer → Insert record

AI-generated

Summary

Insert a new inventory transfer into NetSuite via the SuiteTalk REST API, sending all supplied field values from the node’s Additional Fields and Custom Fields collections and optionally including debug output or request‑header controls.

Inputs

  • Debug Mode — If true, returns full HTTP request and response details together with the record data.
  • Additional Fields — Collection of standard Inventory Transfer fields: Class, Custom Form, Date (tranDate), Department, External ID, Internal ID, Location, Memo, Posting Period, Prefer header (respond‑async), Previous Effective Date, Reference Number (tranId), Reference Name, Replace sublists, Subsidiary, Total, Transfer Location, X‑NetSuite‑Idempotency‑Key, X‑NetSuite‑PropertyNameValidation, and X‑NetSuite‑PropertyValueValidation. Each sub‑collection allows internal or external identifiers. The Inventory item sub‑list requires at least one line with Item (internal or external ID), Quantity To Transfer (adjustQtyBy), and optionally Description, Line, Qty On Hand, Units, and Reference Name. The node accepts multiple inventory lines via the array option.
  • Custom Fields — Optional custom field values to append to the Inventory Transfer record. Supports Boolean, DateTime, Multi‑Select, Number, Select, and String types as defined by NetSuite. Each entry requires a Field Name and Field Type; the value field type aligns with the selected Field Type.

Output shape

The node returns a single JSON object representing the created Inventory Transfer record. If Debug Mode is enabled, the returned item contains two additional properties—request and response—with full HTTP request and response data. The record includes all fields submitted, plus any system‑generated identifiers returned by NetSuite.

The output is provided as an array with one element to comply with n8n’s standard item output format. The record’s exact shape mirrors NetSuite’s response for the Inventory Transfer resource. No pagination is involved in the create operation.

Examples

Example 1: Basic Inventory Transfer

Insert a transfer from location 10 to location 12 of 5 units of item 1001, specifying a memo and posting period.

Example 2: Debugging the Request

Enable Debug Mode to capture the raw HTTP request and response, useful for troubleshooting authentication or payload issues.

Example 3: Idempotent Create

Provide a UUID in X‑NetSuite‑Idempotency‑Key to ensure the same transfer isn’t created twice if the request is retried.

Discussion