NetCash - Tips and Troubleshooting

Overview

This article covers the issues NetCash users hit most often - bank activity not syncing, reconciliations out of balance, automation rules not creating or matching, duplicate transactions, and CSV imports that won't read. If a bank feed stopped, a reconciliation won't tie, an automation rule isn't firing, or a CSV upload shows nothing, start here. Most of these resolve without a support ticket once you know where to look.

Tips

Stagger your automation schedules. If a Create Transaction rule produces duplicate journal entries, the usual cause is the bank-sync job and the automation job running at the same time. Set your automation scripts (NetCash | Bank - Automate - Create / Match / Trans | MR) to run an hour or two *after* your bank sync job so the day's activity is fully imported before rules fire.

Troubleshooting

Before anything else, confirm you're on the latest NetCash SuiteApp version - it resolves many of the issues below. To check your version, visit marketplace.netgain.tech/apps and select Sign In in the top right corner. Follow the prompts to sign into your NetSuite account. Then, select NetCash and check the latest vs installed version.

IssueWhat to check
Bank transactions stopped importing / a day or account is missingCheck:
  • NetCash > Help > NetCash Help - refresh the connection, then reauthenticate the affected account.
  • Confirm the connection is still active (aggregator feeds drop and need re-auth; a sandbox refresh removes Plaid/Finicity setup).
  • A single missing transaction is usually a bank-side posting hiccup - import that one line via CSV (see Importing bank activity) and monitor.
  • For a direct API bank (JP Morgan, BOA CashPro, KeyBank, US Bank, Wells Fargo), a new account only flows once the bank enables it on the API reporting setup - contact your bank representative to confirm the account was added.
Reconciliation is out of balance / shows a varianceCheck:
  • Transactions dated before the cutover date - NetCash excludes pre-cutover bank transactions, so a bank line dated before cutover throws the balance off. Change its date to the cutover date, or create a cutover item for it (NetCash > Setup > Go Live > scroll right > mark the outstanding items > Submit).
  • A changed cutover date removes existing matches and shifts balances - confirm the cutover date is correct before investigating further.
  • Timing differences (entered one month, cleared the next) are normal reconciling items, not errors - leave them outstanding; they clear the following period.
Automation rule isn't creating or matchingCheck:
  • Is the rule's script deployment Scheduled? A Create/Match/Transfer rule that only runs when you click Execute has no scheduled deployment - set NetCash | Bank - Automate - Create/Match/Trans | MR to Scheduled, Daily, No End Date.
  • Subsidiary mismatch: the bank account's subsidiary must be on the entity (vendor/customer) record, or Create Transaction fails with an INVALID/INVALID SUBSIDIARY error.
  • Check/Deposit rules require a Merchant on the bank transaction (it maps to the required Entity field). If your bank feed has no Merchant, use the Journal Entry transaction type instead.
  • Is the bank account included in the rule's Automation Group? A rule won't touch an account that isn't in its group.
  • Grouped match not appearing in Confirm Rule Matches? A blank Date Tolerance defaults to 0 (exact-date match required) - set a tolerance value (auto-matching).
  • Check the Script Execution Logs (see Viewing script errors) for the specific error.
Duplicate bank transactions or duplicate journal entriesCheck:
  • Overlapping schedules - the bank-sync job and the Automate-Create job running at the same time create duplicate JEs. Stagger them (sync first, create 1-2 hours later).
  • Inactive approver in your JE approval workflow - the workflow errors after the JE is created but before it's matched, so the rule retries and duplicates. Replace or reactivate the approver.
  • Transaction Type left blank on a Create Transaction rule batches multiple same-day transactions into one JE and can misfire - set the Transaction Type explicitly.
  • Duplicates from a single bank transaction don't affect your reconciliation (only one match exists) - delete the extra JEs manually and continue.
  • Duplicate imports on a direct-API account can occur if the same account is also connected via an aggregator - use one connection per account.
Manual Match page won't load / spins / can't pull dataCheck:
  • Narrow the date filter. The GL side runs a live query that struggles at high volume; pulling all-time open items can time out. Filter to the period you're reconciling.
  • Clear browser cache/cookies and retry; heavy concurrent NetSuite scripting can time the page out - retry when the account is quieter.
  • Persistent slowness at very high transaction volume is partly a NetSuite database/query limit - open a NetSuite case if narrowing the filter doesn't help.
Match History shows a bank total of zeroCheck:
  • This is almost always a browser caching issue - clear cache/cookies, disable browser extensions, or try a different browser (e.g. Edge).
"You are not enabled as a NetCash User" / can't open NetCash pagesCheck:
  • Open the employee record > NetCash subtab > set NetCash User Type = Full > Save.
  • Check the user's role and that the role has the appropriate NetCash permissions under Permissions > Custom Record.
Reconcile page, Reconciliation Detail, and Proof of Cash don't tieCheck:
  • Usually by design - see the Frequently Asked Questions below for how each is calculated.
  • If the Detail report shows outstanding items that are actually cleared, the reconciliation was submitted before matching finished (the Detail report is snapshotted at submit). Reopen the reconciliation and resubmit.

Importing bank activity (CSV)

When a bank isn't connected by feed, or a feed missed a transaction, you upload activity through NetCash > Setup > Import Bank Activity using the Transaction CSV Import Tool. This is the source of a specific cluster of issues, almost all about how the file is formatted.

Tips for a clean import

  • Include the required fields: Name/Description, Date, Amount (or separate Debit/Credit), and the Account identifier. Save as a comma-delimited `.csv`.
  • Note that the Name field has a 300-character limit but Description and Alt Description have a 4,000-character limit.
  • Use slash-separated dates (ex. `MM/DD/YYYY` or `DD/MM/YYYY`). Dot-separated European dates (`01.01.2026`) are the most common cause of a "date format invalid" error.
  • To route a multi-account file automatically, leave the Bank Account dropdown blank on the import page, then, map the account number column to the account number stored on the NetCash Bank Account record OR map the account text column to the account name stored on the NetCash Bank Account record.
Import issueWhat to check
File uploads but no data appears / everything lands in one columnCheck:
  • The file is delimited by something other than a comma (common with European/German/Swiss/Polish regional settings, which use semicolons). Open the file in Excel and do File > Save As > CSV to re-save it comma-delimited, or use Text-to-Columns to split it, then re-upload.
  • Confirm the required columns (Name, Date, Amount/Debit-Credit, Account) are present.
  • Native support for non-US regional CSV formats is a known limitation with an open enhancement request; the Save-As workaround is the reliable fix today.
"Date format is invalid"Check:
  • Ensure that the date format selected matches the format in the file.
  • Dates must use slashes or dashes. Dot or (in some locales) dash formats fail. Set the date cells to Text or reformat to slashes before saving.
  • European Excel may auto-revert to dot format - re-check after saving.
  • Confirm the latest SuiteApp version (import date handling has been broadened over time).
Data shows the wrong sign after import (debit/credit)In NetCash, debit is cash in and credit is cash out. Oftentimes, the bank statement is opposite. If it's opposite what you expect after upload, reupload using the other field (Amount or Debit/Credit) or you may need to manually edit your file before import to reflect debit = cash in and credit = cash out.
Import error / "NetCash | Data Import | MR" failsCheck:
  • For a scheduled/automated import (e.g. a SuiteScript that imports as -System-), confirm you're on the latest version; a past defect blocked system-run imports.
  • Very large files can hit NetSuite governance limits - split the file into smaller batches.
  • Check the Script Execution Logs (NetCash | Data Import | MR) for the specific error.
Imported the wrong month / a duplicate batchCheck:
  • NetCash > Reports > All Reports > Bank Imports report > select the batch > Permanently Delete Bank Activity > type CONFIRM. Unmatch any matched items in the batch first.
  • To remove a single line, open NetCash Bank Transaction (global search) > Edit > Delete Record, or mark it inactive to keep the history.

Viewing script errors

Most NetCash behavior runs through background Map/Reduce scripts, so the real error is in the logs, not on screen.

- Script Execution Logs - Customization > Scripting > Script Execution Logs. Filter Type = Error and filter to the relevant script (for example, `NetCash | Data Import | MR` for imports or `NetCash | Bank - Automate - Create | MR` for Create Transaction rules), plus the date the issue occurred.

- Map/Reduce Script Status - Customization > Scripting > Map/Reduce Script Status shows whether a job actually ran, is queued, or failed, and on which deployment.

- Per-deployment Execution Log - open the script > Deployments > the deployment > Execution Log subtab to see logs for that specific deployment.

- Log lines read as `script id | stage | error: message` - the message is what support needs.

NetCash scripts

These are the background scripts a customer is most likely to meet in a log or in troubleshooting. Script names and IDs are from the current SuiteApp.

Script (NetSuite name)TypeWhat it doesWhen it runs
NetCash | Data Import | MRMap/ReduceProcesses bank activity uploaded through the Import Bank Activity (CSV) toolWhen you submit a CSV import
NetCash | Bank - Automate - Create | MRMap/ReduceCreates NetSuite transactions (JE, Check, Deposit) from bank activity per your Create Transaction rulesOn its scheduled deployment (set it to run after the bank sync)
NetCash | Bank - Automate - Match | MRMap/ReduceRuns GL Match / auto-match rules against unmatched bank and GL activityScheduled deployment, or on demand via Execute
NetCash | Bank - Automate - Trans | MRMap/ReduceCreates transfers per your Create Transfer rulesScheduled deployment
NetCash | Bank Tran - Plaid | MR (and Finicity, Skript, GoCardless, NetSuite Bank equivalents)Map/ReducePulls bank activity from the aggregator/feed into NetCashOn schedule, typically early each morning
NetCash | Bank Go Live | MRMap/ReduceBuilds cutover items and opening balances during go-liveWhen you generate/refresh the Go Live page
NetCash | Bank App | SLSuiteletServes the NetCash pages (Manual Match, Reconcile, Match History, Dashboard)When you open a NetCash page

Direct bank API connections sync through RESTlets rather than the Map/Reduce jobs above. Several user-event and client scripts also run automatically as you work in NetCash - for example, the user-event script that enforces the NetCash User requirement when you open a NetCash page.

Frequently asked questions

QuestionAnswer
Why don't the Reconcile page, Reconciliation Detail report, and Proof of Cash agree?

They calculate the difference differently and on different dates. The Reconcile and Proof of Cash pages compute an adjusted bank balance (bank balance plus outstanding checks and deposits in transit) against the GL balance, so outstanding items net to zero by design. The Reconciliation Detail report is a period-based snapshot and does not classify an item as outstanding until the month *after* its transaction date. A December check isn't "outstanding" on the December Detail report - it appears once you advance to January. A zero Proof of Cash difference alongside outstanding items on the Detail report is normal.

A transaction shows in NetSuite's native Match Bank Data but not on the NetCash Manual Match page. Why?

Most often the transaction is dated before the cutover date (handle it as a cutover item), or was already picked up by a Create Transaction rule. Pre-cutover items live in the Go-Live cutover flow, not the Manual Match page.

How do I record a beginning/opening balance?

The beginning balance on the Reconciliation Detail report is the cutover-date GL balance, not the Initial Balance field on the bank account. If there's no GL transaction before the cutover date, set the Initial Balance to 0 and bring the opening amount in as a bank transaction / cutover item on the Go-Live page.

How do I tell which transactions are matched vs. unmatched?

There is no native "Cleared" flag like standard NetSuite bank rec. Use the Bank Activity report filtered to matched or not matched, and the Reconcile page per account. The All Reports page lists all available reports.

Why is my credit card reconciliation off by transactions that posted after the statement date?

Credit card charges entered in one month but cleared the next are normal reconciling items - the statement-date vs. posting-date timing gap. Leave them outstanding in the current reconciliation; they clear the following period. NetCash uses the Statement Eligibility Date to handle this timing.

Can I wipe NetCash and start over?

Yes, with the Mass Delete tool, deleting record types in dependency order: Match Items, then Match Groups, Transactions, Bank Accounts, Automation Rules, Automation Groups, Bank Institutions. Note that deleting a bank account also clears its reconciliation records - inactivate rather than delete if you want to keep history.

Can NetCash auto-assign the bank account on a CSV import from the file?

Only if the account number in the file matches the account number stored on the NetCash Bank Account record OR the account text column in the file matches the account name stored on the NetCash Bank Account record. Import templates otherwise upload to the account saved on the template.

How does NetCash connect to my bank and import transactions?

NetCash pulls bank activity through open banking APIs, whether directly or using third-party providers. It does not use bank file transfers, file parsers, or screen scrapes. Where no API connection is available, you bring activity in through the CSV import tool (see Importing bank activity above).

Why can't NetCash connect to my bank?

NetCash does not connect to every bank. A bank has to allow third-party open banking API access, and many banks - and whole regions - have not adopted it. If a bank does not permit API connections, NetCash cannot pull its data and you would import activity by CSV instead. Availability varies by region:

  • Australia: the Consumer Data Right (CDR) requires all banks to provide API access for all account types - the broadest coverage.
  • UK and EU: open banking is regulated. We are not able to connect with any banks in the UK. Banks in the EU vary.
  • US and Canada: there is no broad mandate, so API connectivity is available but limited, especially for business accounts.
  • Latin America, Africa, and Asia: little to no API connectivity today.

If your bank is not connectable, use the CSV import tool, or ask Netgain whether a direct API connection is available.

What is open banking, and why does NetCash use it instead of file transfers or parsers?

Open banking lets you share your bank data with a third-party provider through APIs, replacing older methods: bank file transfers (data files such as the BAI2 cash-management format, which the bank has to send and which vary between banks), file parsers (programs that reformat a bank file for another system), and screen scraping (capturing data from the bank's website). APIs return data in a consistent format with minimal setup and support real-time access and automation, so NetCash uses them by default.

Still need help?

If you've worked through the relevant section and the issue persists, email support@netgain.tech with a detailed description of your issue including any errors or related scripts, how your bank is connected to NetCash, the bank account and reconciliation period involved, and the subsidiary. 


Was this article helpful?