NetSuite icon

NetSuite

NetSuite REST API

Actions7

Remove Record

AI-generated

Overview

This node operation removes a specified record from the NetSuite system using the NetSuite REST API. It is useful for automating the deletion of various record types such as sales orders, customers, invoices, or custom records within NetSuite. For example, it can be used to programmatically delete obsolete sales orders or remove outdated customer records.

Use Case Examples

  1. Deleting a sales order by its internal ID.
  2. Removing a custom record by specifying its script ID and internal ID.

Properties

Name Meaning
Record Type Specifies the type of NetSuite record to remove, such as sales order, customer, invoice, or custom record.
Custom Record Script ID The internal identifier of the Custom Record type, required if the record type is custom. Usually starts with 'customrecord'.
ID The internal identifier of the record to be removed. Can be prefixed with 'eid:' to use the external identifier.
API Version The version of the NetSuite API to use for the request, default is v1.
Options Additional options for the request such as concurrency control and whether to return the full response.

Output

JSON

  • json
    • success - Indicates if the record removal was successful (true if HTTP status 204).
    • id - The internal ID of the removed record if available from the response headers.
    • propertyValidation - List of property validation errors if any were returned by NetSuite.
    • operationId - Operation ID returned by NetSuite for tracking.
    • jobId - Job ID returned by NetSuite for tracking.
    • error - Error message if the removal failed and continueOnFail is enabled.

Dependencies

  • NetSuite REST API
  • An API key credential for authentication

Troubleshooting

  • Common issues include invalid or missing internal ID, incorrect record type, or insufficient permissions to delete the record.
  • Error messages may include HTTP status codes other than 204 indicating failure, or specific error details returned by NetSuite in the response body.
  • Ensure the internal ID is correct and the API credentials have delete permissions for the specified record type.
  • If continueOnFail is false, the node will throw an error on failure; otherwise, it returns an error object in the output.

Links

Discussion