NetSuite Banking Plug-in Refresh Interface Guide
Review Financial Institution Connectivity refresh methods, configuration access, and the implementation details Oracle's interface listing leaves...
The NetSuite Financial Institution Connectivity Plug-in reference lists refresh methods alongside configuration and transaction interfaces. It identifies configuration access and methods for account errors, request IDs, and refresh status, but does not establish a release date or provide the detailed contracts needed to implement those methods.
Which Refresh Methods Does the Reference List?
Two interface functions are the focus of this review: refreshData(context) and getRefreshRequestStatus(context). Oracle lists pluginConfiguration and getConfigurationFieldValue() for both, with different additional object functions for each.
| Interface function | Listed configuration object | Listed object functions |
|---|---|---|
refreshData(context) | pluginConfiguration | getConfigurationFieldValue(), addAccountError(options), setRefreshRequestId(options) |
getRefreshRequestStatus(context) | pluginConfiguration | getConfigurationFieldValue(), returnRefreshRequestStatus(options) |
Implementation boundary: The supplied excerpt does not define the options schemas, supported statuses, invocation timing, or error-handling behavior. Use this table to identify the relevant methods, not to infer payloads or execution order. Review their individual contracts before changing connector code.
How Does Configuration Access Fit In?
The pluginConfiguration interface object retrieves user-supplied configuration field values through getConfigurationFieldValue(). Oracle specifically directs custom plug-in authors to use this access mechanism for configuration_id.
The refresh rows list that same configuration object. However, the separate object's parent list names only the four non-refresh functions below. That difference in documentation is not enough to establish a runtime restriction.
| Other interface function | Additional listed members |
|---|---|
getConfigurationIFrameUrl() | configurationIFrameUrl |
getAccounts() | addAccount() |
getTransactionData() | accountRequestsJSON, addDataChunk(), returnAccountRequestsJSON() |
getTransactionSources() | addSourceList() |
All four also list pluginConfiguration and getConfigurationFieldValue(). The configuration object's reference lists no child objects.
Where Does the Configuration URL Appear?
getConfigurationIFrameUrl(context) provides the financial-institution connection configuration UI. For most plug-in authors, this is a Suitelet URL. The URL appears on a format profile record's Connectivity Configuration subtab.
The function returns void; its context contains pluginConfiguration and configurationIFrameUrl. Oracle's example reads configuration_id and includes it in the URL assigned to configurationIFrameUrl:
1function getConfigurationIFrameUrl(context) {2 var configurationId = context.pluginConfiguration.getConfigurationFieldValue({3 fieldName: "configuration_id"4 });5 context.configurationIFrameUrl =6 "/app/site/hosting/scriptlet.nl?script=1&deploy=1&configurationId=" + configurationId;7}Treat the script and deployment identifiers as example values, not deployment instructions. This example illustrates configuration access and URL assignment; it does not demonstrate refresh execution.
Who This Affects
- Banking integration developers: Use the refresh inventory to identify which individual method contracts need review before implementation.
- Administrators maintaining format profiles: The documented location for the connection configuration UI is the Connectivity Configuration subtab.
- Connector support teams: Oracle lists a related error-handling topic, but this excerpt supplies no detailed account-error rules.
Key Takeaways
- The refresh interface listing includes request-ID, account-error, and status-reporting methods.
pluginConfigurationprovides access to user-supplied configuration values.- The configuration URL example does not establish refresh behavior.
- The supplied reference does not identify a release-specific change.
Frequently Asked Questions (4)
Which methods should I review when implementing Financial Institution Connectivity refresh logic?
How does a refresh plug-in retrieve user-supplied configuration values such as `configuration_id`?
Where does the financial-institution connection configuration UI appear in NetSuite?
Does the configuration URL example show how to execute a refresh?
Weekly Update History (1)
Updated Financial Institution Connectivity Plug-in Interface Definition to document importing multiple bank statement files using getTransactionSources(), addSourceList(), and sourceName.
View Oracle DocsWas this article helpful?
More in Banking
- Enriched Bank Data for Improved Transaction Matching in NetSuite
Updated for NetSuite 2026.1: Enriched Bank Data feature enhances transaction matching accuracy using generative AI.
- NetSuite Match Bank Data: Match, Clear and Reconcile
Use Match Bank Data to review bank lines, resolve exceptions and submit transactions before completing a NetSuite statement reconciliation.
- Testing Versapay Payment Gateway Connection in NetSuite Pay
Connect and test Versapay Payment Gateway for NetSuite Pay, verifying configurations safely without financial risk.
- Australia Bank Feeds SuiteApp Enhancements for NetSuite 3.0.0
NetSuite 2026.2 adds ANZ reporting updates, Singapore billing validations and GST InvoiceNow access, and UAE electronic invoicing.
Also from NetSuite 2026.2
- Bank Matching and Reconciliation Enhancements in NetSuite 2026.2
Bank matching and reconciliation pages in NetSuite 2026.2 receive critical UI enhancements for improved transaction management.
- System Notes Enhancement for Reconciliation in NetSuite 2026.2
System notes enhancement tracks GL transaction events in NetSuite 2026.2, improving reconciliation auditing and review.
- SuiteCloud CLI License Acceptance for Automation
Set SUITECLOUD_CLI_ACCEPT_LICENSE=true to suppress the SuiteCloud CLI license prompt during scripted npm installation.
- NetSuite Next: Readiness, Preview, and Ask Oracle
Eligible administrators can request a NetSuite Next preview, set up Ask Oracle, and prepare data, roles, customizations, and navigation.
Advertising
Reach Banking Professionals
Put your product in front of NetSuite experts who work with Banking every day.
Sponsor This Category