Preparing CSV Files for Import
Statement files in CSV format must adhere to the provided CSV template and constraints. The file must be UTF-8 encoded.
You can download the CSV template by going to Transactions > Bank > Banking Import History > Upload File, selecting Import with a default parser (CSV, OFX, QFX, BAI2, or CAMT.053), and clicking Download the CSV template.
Alternatively, you can create the file with the required columns and specifications.
If you are using Excel, ensure the file is UTF-8 encoded. Go to File > Save As, and then select CSV UTF-8 (Comma delimited) (*.csv) from the file format list.
The CSV file can only contain transactions that belong to a single account.
To ensure successful import, the column headings must be in the first row in the specified order as follows: Date (MM/DD/YYYY), Payor/Payee Name, Transaction ID, Transaction Type, Amount, Memo, NS Internal Customer ID, NS Customer Name, Invoice Number(s).
The following column data is required:
The Memo field is optional. The memo must not exceed 4000 characters and must not include any commas, semicolons or underscores.
-
Date (MM/DD/YYYY) – The transaction date. Content must be in the format of MM/DD/YYYY. A one–digit month must be preceded by a zero. If you are using Excel, ensure that the date does not get reformatted.
-
Payer/Payee Name – Payer or Payee name. There is a limit of 70 characters.
-
Transaction ID – Unique Bank Transaction or Reference ID. This can also be populated with the check number. There is a limit of 90 characters.
-
Transaction Type – Values in this column must be one of the following transaction types, all uppercase: CREDIT, DEBIT, CHECK, PAYMENT, ACH, INTEREST, DEPOSIT, TRANSFER, FEE, OTHER.
-
Amount – The amount column must be a single column. If your file contains CREDIT and DEBIT columns, combine them into a single amount column. Positive amounts are CREDITS. Negative amounts are DEBITS, and must begin with a minus sign or be in parentheses.
The amount column must not contain currency symbols or commas instead of decimal places. The amount currency should be in the same currency as the selected account.
-
Memo (Optional) – There is a limit of 4000 characters for the memo. The Memo field must not include any commas, semicolons or underscores.
-
NS Internal Customer ID – (Optional) The NetSuite internal customer ID. Content must be numeric. There is a limit of 12 characters.
When you import the statement, NetSuite uses the customer ID first to try to match the statement to a NetSuite customer. If the customer ID is missing, NetSuite checks for a customer name next.
-
NS Customer Name – (Optional) If the specified customer ID does not match any data, NetSuite uses the value to look up the customer ID. Content is free-form text. The character limit is 512.
When you import the statement, if the customer ID is missing, NetSuite uses the customer name to try to match the statement to a NetSuite customer. If the customer name is missing, NetSuite checks for invoice numbers.
-
Invoice Number(s) – (Optional) A comma-separated list of invoice numbers in a single field, with no spaces between numbers (for example, 132,133,134). If you use a script or comma-separated file instead of the CSV template in a spreadsheet, put quotation marks around multiple invoice numbers (for example, “132,133,134”). For each invoice number in the list, there is a limit of 128 characters. If the imported file specifies multiple invoices for a transaction, they must all belong to same customer and AR account.
When you import the statement, if the customer name and customer ID are both missing, NetSuite uses the invoice numbers to try to match the statement to a NetSuite customer. If the customer name, ID, and invoice numbers are all missing, the system cannot perform an exact match. However, NetSuite can match the statement to a customer in other ways. See Customer Match Criteria.
If you exceed the character limit for any field, the import fails. If you use multibyte characters, the character limit may become less.
If present, remove the following:
-
Empty columns (containing no data) between other filled columns.
-
Empty rows (containing no data) between other filled rows.
-
Columns containing opening and closing balances.
-
Any columns not specified by the template.
-
Multiple accounts.
-
Bank account number.