NetSuite REST Azerion icon

NetSuite REST Azerion

Call NetSuite SuiteTalk REST operations.

Actions981

Consolidated Exchange Rate → Insert record

AI-generated

Summary

Create a new Consolidated Exchange Rate record.

Inputs

  • isDebugMode — Whether to include full request and response info in the output
  • authMethod — Authentication method to use for the request (OAuth1 or OAuth2)
  • externalId — External identifier for the consolidated exchange rate record
  • id — Internal identifier for the consolidated exchange rate record
  • fromCurrency — Currency conversion from (select internal or external identifier)
  • toCurrency — Currency conversion to (select internal or external identifier)
  • fromSubsidiary — Subsidiary converting from (select internal or external identifier)
  • toSubsidiary — Subsidiary converting to (select internal or external identifier)
  • periodStartDate — Date on which the accounting period began
  • postingPeriod — Posting period for the exchange rate (select internal or external identifier)
  • averageRate — Average exchange rate calculated from weighted average of transactions for accounts with rate type Average; used for income statement and retained earnings
  • currentRate — Current (ending) exchange rate effective at the end of the reported period; used for most asset and liability accounts in the balance sheet
  • historicalRate — Historical exchange rate calculated from weighted average of transactions for accounts with rate type Historical; used for equity accounts and owner's investments in the balance sheet
  • isDerived — If checked, the exchange rate is indirect (set between subsidiaries more than one hierarchical level removed); rates are system-set and cannot be edited or auto-calculated
  • isEliminationSubsidiary — If checked, the subsidiary is an elimination subsidiary; rates for elimination subsidiaries cannot be edited
  • isPeriodClosed — If checked, the accounting period is closed
  • replace — Comma-delimited names of sublists on this record; all sublist lines will be replaced with lines specified in the request
  • Prefer — Server behavior requested by the client; use 'respond-async' to execute the request asynchronously; if executed asynchronously, 'Preference-applied: respond-async' is returned in the response
  • X-NetSuite-Idempotency-Key — User-defined unique idempotency key applied to every asynchronous request to ensure execution only once; use UUID in RFC 4122 string format; ignored for synchronous requests
  • X-NetSuite-PropertyNameValidation — Sets strictness of property name validation (Error, Warning, or Ignore)
  • X-NetSuite-PropertyValueValidation — Sets strictness of property value validation (Error, Warning, or Ignore)
  • customFields — List of custom fields to add to the record; supports multiple values and various field types (boolean, dateTime, number, string, select, multiSelect)

Output shape

The operation inserts a new Consolidated Exchange Rate record into NetSuite. On success, the returned data typically includes the record's internal ID, external ID (if set), and other field values as confirmation of creation. Debug mode includes full request and response details when isDebugMode is enabled.

Authentication is configured per-node credentials; the authMethod parameter (OAuth1/OAuth2) selects the auth scheme. All parameters not explicitly set retain their NetSuite defaults. The Prefer header with value 'respond-async' enables asynchronous execution. The X-NetSuite-Idempotency-Key ensures unique execution for async requests.

Examples

Example 1: Create a consolidated exchange rate record with a current rate from USD to EUR for a specific subsidiary pair.

Set fromCurrency, toCurrency, fromSubsidiary, toSubsidiary, currentRate, and periodStartDate. Leave isDebugMode at default false. Use default authMethod (OAuth1).

Links

Discussion