NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Bin → Insert or update record

AI-generated

Summary

Update an existing NetSuite Bin record using its external identifier, or create a new Bin record if the identifier does not exist. Set standard and custom fields, and optionally manage inventory balances for associated items and locations.

Inputs

  • Id (required) — The external identifier of the Bin record to update or create.
  • Bin Number — A unique number, name, or code to identify the bin's location (e.g., 'AA01'). Cannot contain an ampersand.
  • External ID — An additional external identifier for the bin.
  • Inactive — Set to true to make the bin inactive, removing all references to it.
  • Internal ID — The internal identifier of the bin. This field is typically used when the primary 'Id' is an external identifier.
  • Inventory Balance — A list of items and their associated quantities within this bin. Each item can specify available, committed, on-hand, and picked quantities, along with its internal or external ID and the location's internal or external ID.
  • Last Modified Date — The date and time the bin record was last modified.
  • Memo — A descriptive note for the bin, visible only on this record.
  • Prefer — Specify 'respond-async' to execute the request asynchronously. The response will include 'Preference-applied: respond-async' if applied.
  • Reference Name — A reference name for the bin.
  • Replace — A comma-delimited list of sublist names to replace. All existing lines in specified sublists will be replaced by those provided in the request body.
  • Replace Selected Fields — If true, all fields intended for deletion in the update request, including body fields, must be listed in the 'Replace' query parameter.
  • X - Net Suite - Idempotency - Key — A unique UUID (RFC 4122) used for asynchronous requests to ensure the request is executed only once. Ignored for synchronous requests.
  • X - Net Suite - Property Name Validation — Sets the strictness of property name validation ('Error', 'Warning', or 'Ignore').
  • X - Net Suite - Property Value Validation — Sets the strictness of property value validation ('Error', 'Warning', or 'Ignore').
  • Custom Fields — A list of custom fields to set on the Bin record, specifying the field name, type (Boolean, Date Time, Multi Select, Number, Select, String), and corresponding value.

Output shape

a single record

Returns the updated or newly created Bin record with its identifier and details. If 'Debug Mode' is enabled, the output will also include full request and response information.

Examples

Example 1: Update a bin's description

Set 'Id' to the bin's external ID, and provide a 'Memo' in 'Additional Fields'.

Example 2: Mark a bin as inactive

Set 'Id' to the bin's external ID, and set 'Inactive' to 'true' in 'Additional Fields'.

Example 3: Update an item's available quantity in a specific bin

Set 'Id' to the bin's external ID. Under 'Inventory Balance', add an 'Item', specify the 'Item's' internal or external ID, and set the 'Available Quantity'.

Discussion