NetSuite REST Azerion icon

NetSuite REST Azerion

Call NetSuite SuiteTalk REST operations.

Actions981

Currency → Insert or update record

AI-generated

Summary

Upsert a currency record in NetSuite by external or internal identifier.

Inputs

  • id (required) — External identifier. Required to target the currency record.
  • isDebugMode — Whether to include full request and response info in the output. Default: false.
  • authMethod — Authentication method. Options: OAuth1, OAuth2. Default: oauth1.
  • name — Enter a unique name for the currency. Recommended to include country or abbreviation.
  • isBaseCurrency — Indicates that this currency is the company's base currency or a subsidiary's base currency in OneWorld accounts. Cannot be changed after foreign-currency transactions exist.
  • symbol — Enter the three-letter ISO code for this currency (e.g., USD, EUR).
  • isInactive — Check to make the currency record inactive. Cannot be activated if open transactions exist in that currency.
  • overrideCurrencyFormat — Check to customize the currency format.
  • displaySymbol — Enter the currency symbol and text to use for this currency (e.g., '$ USD').
  • symbolPlacement — Collection specifying symbol placement internal identifier.
  • X-NetSuite-Idempotency-Key — User-defined unique idempotency key for asynchronous requests (RFC 4122 UUID string). Only one request per unique key; ignored for synchronous requests.
  • X-NetSuite-PropertyNameValidation — Sets strictness of property name validation. Options: Error, Warning, Ignore. Default: empty (no validation).
  • X-NetSuite-PropertyValueValidation — Sets strictness of property value validation. Options: Error, Warning, Ignore. Default: empty (no validation).
  • additionalFields — Collection of additional currency fields including includeInFxRateUpdates, currencyPrecision, exchangeRate, externalId, formatSample, fxRateUpdateTimezone, refName. Precision can be zero or two; exchange rate is base currency amount divided by foreign currency amount.
  • customFields — Fixed collection for custom field values. Multiple values allowed. Each entry includes fieldName (loaded via loadCustomFields), fieldType (boolean, dateTime, multiSelect, number, select, string), and corresponding value.

Output shape

The updated or created currency record object as recognized by the NetSuite REST API. Full request/response details included in output if isDebugMode is enabled.

The operation targets a currency by the provided id (internal or external). If the identifier exists, the record is updated with the supplied fields; otherwise, a new record is created. Authentication is handled via the selected authMethod.

Examples

Example 1: Update the USD exchange rate and mark it as the base currency.

Set id to the currency's external ID, exchangeRate to the desired rate, isBaseCurrency to true, and isInactive to false.

Links

Discussion