NetSuite REST icon

NetSuite REST

Call NetSuite SuiteTalk REST operations.

Actions979

Fair Value Price → Insert record

AI-generated

Summary

Create a new Fair Value Price record in NetSuite using the SuiteTalk REST API.

Inputs

  • isDebugMode — Include full request and response data in the output
  • accountingBook — Accounting book reference – internal ID or external ID
  • fairValue — Base fair value of the item
  • currency — Currency reference – internal ID or external ID
  • customForm — Custom form reference – internal ID or reference name
  • customer — Customer reference – internal ID or external ID
  • endDate — Expiration date of the fair value price
  • externalId — Custom external ID for the record
  • fairValueFormula — Reference to a fair value formula – internal ID or external ID
  • fairValueRangePolicy — Policy for fair value range – options are HIGH, LOW, BOUNDARY, FAIRVALUE
  • highValue — Absolute high value of the range
  • highValuePercent — Percentage of base fair value for high range
  • id — Internal ID of the record (unused for insert)
  • isVsoePrice — Indicates if the fair value is VSOE based
  • item — Item reference – internal ID or external ID
  • itemRevenueCategory — Revenue category reference – internal ID or external ID
  • lowValue — Absolute low value of the range
  • lowValuePercent — Percentage of base fair value for low range
  • Prefer — Server preference – use 'respond-async' for async processing
  • refName — Reference name of the record
  • replace — Comma‑separated list of sublist names to replace
  • sourceType — Source type reference – internal ID or reference name
  • startDate — Effective start date of the fair value price
  • subsidiary — Subsidiary reference – internal ID or external ID
  • units — Unit value for the fair value price
  • unitsType — Units type reference – internal ID or external ID
  • X-NetSuite-Idempotency-Key — UUID to guarantee idempotent asynchronous requests
  • X-NetSuite-PropertyNameValidation — Strictness of property name validation (Error, Warning, Ignore)
  • X-NetSuite-PropertyValueValidation — List of custom field values for the record

Output shape

a single record representing the newly created Fair Value Price

If the Debug Mode flag is set, the output also contains the raw HTTP request and response data.

Examples

Example 1: Create a Fair Value Price for a specific item

Set Item → internal ID 12345, Fair Value → 150.00, Start Date → 2024-01-01, End Date → 2024-12-31, Currency → internal ID 1; leave other fields empty.

Example 2: Include a custom field and validation headers

Add Custom Field with name 'MSO_Classification' (select type string) and value 'Commercial'; set X-NetSuite-PropertyNameValidation to 'Error'; set X-NetSuite-PropertyValueValidation to 'Warning'.

Example 3: Use idempotency key for reliable asynchronous processing

Set Prefer to 'respond-async' and provide X-NetSuite-Idempotency-Key with a UUID; set Start Date and End Date accordingly.

Discussion