Banxico Exchange Rate Setup in NetSuite with MXN

Prepare currency records, Banxico credentials, and an API secret to import MXN-denominated exchange rates through Mexico Complementary Features.

·5 min read·NetSuite 2026.2·View Oracle Docs

The Mexico Complementary Features SuiteApp connects NetSuite to Banxico to import exchange rates expressing foreign-currency values in Mexican pesos. NetSuite applies these rates to foreign-currency transactions for subsidiaries with MXN as their base currency. Before setup, enable Multiple Currencies, prepare currency records, register with Banxico, and create an API secret.

What Does the Banxico Integration Do?

The Mexico Complementary Features SuiteApp enables integration with Banco de México, or Banxico, to import currency exchange rates.

The currency direction matters: imported rates express the value of currencies outside Mexico in Mexican pesos (MXN). For subsidiaries whose base currency is MXN, NetSuite applies those rates to transactions in other currencies. The documentation does not establish equivalent behavior for subsidiaries using another base currency.

Before planning implementation, distinguish two requirements: having an MXN currency record and having a subsidiary whose base currency is MXN. The record is a setup prerequisite; the subsidiary's base currency determines the documented transaction application.

What Must Be Ready Before Setup?

Complete these prerequisites before configuring the integration:

  1. Enable Multiple Currencies in the account.
  2. Create or verify currency records for Mexican peso and every currency whose rates you want to import from Banxico.
  3. Register with Banxico to obtain the exchange-rate API base URL and token.
  4. Create an API secret using the Banxico token, and record the script ID you define for that secret.

Keep the credential handoff precise: Banxico supplies the token, which is used to create the API secret. The secret's script ID is a separate setup detail that the documentation explicitly tells you to retain.

The documentation also references prerequisites for installing the Mexico Complementary Features SuiteApp without reproducing them. Review those separately; these four integration requirements are not a complete SuiteApp installation checklist.

How Should Currency Records Be Prepared?

Multiple Currencies supplies four currencies by default:

Country or regionCurrencyCode
CanadaDollarCAD
European UnionEuroEUR
Great BritainPoundGBP
United StatesDollarUSD

MXN is not in that default list. Check existing records before creating additional currencies. NetSuite supports all ISO 4217 standard currencies, and each currency requires a name, default locale, ISO code, and default exchange rate.

To create a record, go to Lists > Accounting > Currencies > New.

FieldSetup guidance
NameEnter a unique name. A country-qualified name such as Mexican peso distinguishes it from pesos used in the Philippines or Uruguay.
Default LocaleSelect the country that determines the currency format.
ISO CodeNetSuite displays the three-letter ISO code associated with the selected locale.
Default exchange rateEach currency requires a default exchange rate; the excerpt does not explain its calculation.
Format SampleReview the displayed default format, including the symbol, thousands separator, and decimal precision.

The currency name becomes an option on customer, vendor, and other records. Naming therefore affects more than the import setup: users selecting currencies on those records need to distinguish Mexican pesos from other peso currencies.

Changing the ISO code to an unsupported value produces a warning. The currency-record documentation states that non-standard ISO codes significantly slow exchange-rate updates and that a valid ISO code is required for the Currency Exchange Rate Integration feature. It does not describe a separate Banxico-specific code-validation process.

What Is the Setup and Verification Sequence?

The documentation identifies four implementation topics:

  1. Setting up the integration with Banxico.
  2. Setting up currencies for exchange-rate import.
  3. Deploying the Banxico Exchange Rate Import Script.
  4. Verifying exchange rates imported from Banxico.

For related implementation context, see Banxico exchange rate prerequisite, deployment, and verification guidance.

The supplied material names these stages but does not provide deployment parameters, scheduling defaults, supported currency coverage, or detailed verification procedures. Treat the prerequisite checklist as preparation for those instructions, not as a complete deployment guide.

As a practical acceptance check, compare an imported rate with the corresponding Banxico value and confirm that its direction is foreign currency expressed in MXN. Also check the intended subsidiary's base currency. These are recommended checks based on the documented scope, not additional documented configuration requirements.

Does the Referenced Role Guidance Apply to Banxico?

The referenced Multiple Currencies excerpt describes Costed Bill of Materials role and script changes. It does not establish permissions for the Banxico import script.

Do not copy that manufacturing-specific role configuration as a Banxico requirement. The supplied material does not specify Banxico permissions; consult the integration setup instructions for that part of implementation.

Who This Affects

  • Administrators: Coordinate Multiple Currencies, currency records, and API-secret preparation before integration setup.
  • Integration developers: Obtain the Banxico API base URL and token, retain the secret's script ID, and review the import-script deployment instructions.
  • Accountants and finance teams: Review imported rates and their intended application to foreign-currency transactions in MXN-base subsidiaries.

For broader documentation context, review the NetSuite 2026.2 documentation additions and updates.

Key Takeaways

  • The Mexico Complementary Features SuiteApp imports Banxico exchange rates expressing foreign-currency values in MXN.
  • The documented transaction application concerns subsidiaries with MXN as their base currency.
  • Multiple Currencies, currency records, Banxico registration, and an API secret are prerequisites.
  • Prepare currency records before moving to import configuration, script deployment, and verification.
  • Do not substitute Costed Bill of Materials permissions for Banxico setup guidance.

Frequently Asked Questions (4)

Which subsidiaries and transaction currencies use the Banxico-imported exchange rates?
The imported rates express foreign-currency values in Mexican pesos (MXN). NetSuite applies them to transactions in other currencies for subsidiaries whose base currency is MXN; the documented behavior does not establish equivalent application for subsidiaries with another base currency.
What needs to be ready before configuring the Banxico integration?
Enable Multiple Currencies, create or verify currency records for MXN and each currency you want to import, register with Banxico for its API base URL and token, and create an API secret using that token. Record the secret's script ID separately. These are integration prerequisites, not a complete checklist for installing the SuiteApp.
Do I need to create an MXN currency record if I already have a subsidiary with MXN as its base currency?
Yes. The MXN currency record is a setup prerequisite, while the subsidiary's MXN base currency determines the documented application of imported rates to transactions. Check for an existing MXN record before creating another; MXN is not among the currencies supplied by default with Multiple Currencies.
Can I use the Costed Bill of Materials role guidance to set Banxico import permissions?
No. The referenced role and script changes concern Costed Bill of Materials and do not establish permissions for the Banxico import script. Consult the Banxico integration setup instructions for its permissions guidance.

Weekly Update History (1)

Country-Specific Featuresadded

Added the Currency Exchange Rate Integration with Banxico help topic.

View Oracle Docs
Source: Currency Exchange Rate Integration with Banxico — Oracle NetSuite Help Center. This article was generated from official Oracle documentation and enriched with additional context and best practices.

Was this article helpful?

More in Currency

View all Currency articles →

Also from NetSuite 2026.2

View all NetSuite 2026.2 changes →