NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Discount Item → Insert record

AI-generated

Summary

Creates a new Discount Item in NetSuite via the SuiteTalk REST API.

Inputs

  • isDebugMode — Whether to include full request and response info in the output.
  • itemId (required) — Enter up to 250 characters for the name of this item; it appears in lists on transactions.
  • displayName — Enter an optional name of up to 250 characters for this item in addition to the Item Name.
  • description — Enter a description for this item. It will appear in the Description column of sales forms.
  • rate — Enter the rate for this discount or markup. The rate can be a percentage (e.g. 10%) or a dollar amount.
  • isPreTax — Check to apply this discount before taxes are calculated. Relevant only for countries that levy sales tax.
  • isInactive — When checked, this item will no longer appear on a list unless you select Show All.
  • includeChildren — Share the item with all sub‑subsidiaries of each subsidiary selected.
  • account — Associate an account with the discount item. Specify either an internal or external identifier.
  • class — Associate a class with the discount item by internal or external identifier.
  • department — Associate a department with the discount item by internal or external identifier.
  • customForm — Specify a custom form by internal identifier or reference name.
  • subsidiary — Associate subsidiaries by internal or external identifier.
  • vendorName — Specify the vendor’s name for this item; used when the vendor’s name differs from the item name.
  • upcCode — Enter a UPC code for the item; printed on item labels.
  • translations — Provide translations for store and sales descriptions, display names, and detailed/featured descriptions per locale.
  • customFields — A list of custom fields to attach to the record, each with field name, type, and value.
  • X-NetSuite-Idempotency-Key — A unique UUID to ensure the request is executed only once for asynchronous calls.
  • X-NetSuite-PropertyNameValidation — Set the strictness of property name validation (Error, Warning, Ignore).
  • X-NetSuite-PropertyValueValidation — Set the strictness of property value validation (Error, Warning, Ignore).

Output shape

a JSON object representing the created Discount Item record, including NetSuite-assigned identifiers

If Debug Mode is true, the output includes an additional "debug" section containing full request and response details. Pagination is not applicable for this operation.

Examples

Example 1: Create a basic discount item

Set itemId to "DISC10", description to "10% off on all sales", rate to 10, and isPreTax to true. Run node to create the record.

Example 2: Create an item with custom account and class

Set itemId to "DISC20", rate to 20, customForm internal id to 103, account internal id to 200, and class internal id to 300. This links the item to the specified account and class.

Example 3: Add custom fields to a discount item

Set itemId to "DISC30", rate to 30, and add a custom field named "customTag" of type string with value "summerpromo" using the customFields collection.

Discussion