How to Import Checks into QuickBooks Online (UK, AU, CA, IN, FR & Other Regions)?

January 1, 2025

You can import Checks from Excel spreadsheets or text files directly into QuickBooks Online using the SaasAnt Transactions (Online) application.

Pre Requisites:

Connect your QuickBooks Online to SaasAnt Transactions (Online) App from QuickBooks AppStore by clicking the "Get App Now" buttonYou can get a free trial of the product in the QuickBooks AppStore.

Steps to Import Checks into QuickBooks Online

To import Checks into QuickBooks Online using the SaasAnt Transactions (Online) application, follow the steps below

Click on the "Upload File" Menu and upload your file.

Step 1: Select your file and spreadsheet with the check you want to import.

Step 2: Select the QuickBooks entity as Check.

Step 3: Set up the mapping of the columns in your check import file to the corresponding fields in QuickBooks.(Refer to the below Section).

Step 4: Click Import, and your check will be directly added to your QuickBooks company.

The critical step in the import is to map your file headers to the QuickBooks field in Step 3 of the import. Some key steps are below:

  • You must map your file headers to "SaasAnt Transactions (Online)" fields. This mapping will enable us to import your transactions properly into QuickBooks company.

  • In the mapping screen, we have the "Preview Mapping" button, which can help you visualize your current mappings as per the QuickBooks screen with your file headers.

  • Please refer basics of field mappings for more info. If you have any confusion or doubts, feel free to email [email protected].

Import Checks into QuickBooks Online

How to Import Checks into QuickBooks Online (New User Interface 2.0)

1) Login into SaasAnt Transaction Online

2) Select the New Import Tab.

3)  Select TransactionList, or Attachment to upload your file into QuickBooks.

4) Select the QuickBooks entity as "Checks".

5) Select the files you want to upload.

6)  Set up the Mapping of the columns in your Checks.

7) Select the "Preview Mapping" button to visualize current mapping based on QuickBooks.

8) Select the "Review" button to view the mapped Excel data according to the QuickBooks file headers.

9) Select the Upload tab.

10) The data was imported successfully into Quickbooks.

Let’s have a look at the SaasAnt Transactions Online Fields.

SaasAnt Transactions (Online) Fields

Field Name

Format

Description

Check No

21 Characters

Reference number for the transaction.

Payee

Characters

Name of the vendor / Customer / Employee for this transaction.

Account

Characters

Name of the Account for this transaction.

Payment Date

Date

The date entered by the user when this transaction occurred.

Memo

4000 Characters

The Note about the Bill Transaction.

Mailing Address Line 1

500 Characters

First line of the address.

Mailing Address Line 2

500 Characters

Second line of the address.

Mailing Address Line 3

500 Characters

Third line of the address.

Mailing Address City

255 Characters

City name.

Mailing Address Postal Code

31 Characters

Postal code (zip code for USA and Canada).

Mailing Address Country

255 Characters

Country name

Mailing Address Country Sub Division Code

255 Characters

Region within a country

Global Tax Calculation

Characters

Method in which tax is applied.

  • TaxExcluded

  • TaxInclusive

  • NotApplicable

Expense Account

Characters

Reference to the Expense Account Name associated with the billing.

Expense Description

4000 Characters

Free form text description of the Expense.

Expense Line Amount

Decimal

The amount of the line item.

Expense Billable Status

Boolean

The billable status of the expense.
TRUE if Billable, FALSE If Not Billable.

Expense Markup Percent

Decimal

The Markup value in Percentage for the expense.

Expense Customer

Characters

Reference to the Customer associated with the expense.

Expense Class

Characters

Reference to the Class for the Expense.

Expense Tax Code

Characters

Reference to the Purchase Tax Code

Expense Account Tax Amount

Decimal

The calculated tax amount for an Expense Account line. Applicable only for Tax calculated Transactions. This value will be ignored for Tax Inclusive Transactions.

Line Item
or
Product/Service

Characters

Reference to the Item.

Line Item Description
or
Product/Service

4000 Characters

Description of the Item. It will be populated from Item description entered in QuickBooks Online.

Line Item Quantity
or
Product/Service Quantity

Decimal

The Quantity of the Item.

Line Item Rate
or
Product/Service Rate

Decimal

The Unit Price of the Item.

Line Item Amount
or
Product/Service Amount

Decimal

The Total Amount of the Item. Not required if Line Item Quantity & Line Item Rate is present.

Line Item Billable Status
or
Product/Service Billable Status

Boolean

The billable status of the Item.
TRUE if Billable, FALSE If Not Billable.

Line Item Tax Code
or
Product/Service Tax Code

Characters

The purchase tax code for the line Item.

Line Item Tax Amount
or
Product/Service Tax Amount

Decimal

The calculated tax amount for a product line. Applicable only for Tax calculated Transactions. This value will be ignored for Tax Inclusive Transactions.

Line Item Markup Percent
or
Product/Service Markup Percent

Decimal

The Markup value in Percentage for the Item.

Line Item Customer
or
Billable Customer:Product/Service

Characters

The Customer name for the Item.

Line Item Class
or
Product/Service Class

Characters

The Class name for the Item.

Location

Characters

The location of the transaction.

Currency Code

Characters

The Currency Code for this transaction.

Exchange Rate

Decimal

The exchange rate of the given currency against the home currency.

Print Status

Boolean

TRUE / FALSE
T/F
Y/N

FAQ's

Most of us would have questions while moving data to your QuickBooks Online. Some of them for your reference below:

Will your application support Multi Line Transactions?

Yes. It will. More Info...

I made some mistakes in the mapping. Your application was imported wrongly. So, my QuickBooks file got corrupted. Is there any way to undo or revert?

Sometimes, it happens due to the wrong mapping. It is possible to delete the entire transactions which went wrong. Our DELETE feature is the rescue. More Info...

I want to import Checks using SKUs. Is it supported?

Yes. It is. You need to enable a couple of settings while importing. More Info...

I want to get an email for each upload. Is it possible?

Yes. It is. You need to enable a couple of settings while importing. More Info...

Does your app support taxes?

Yes. It does. Tax model.

I don't want to create products automatically for my invoices. I can't develop products before each upload. Is it supported?

Yes. It is. You need to enable a couple of settings while importing. However. You can control this behavior. More Info...

My file has some specific date format. I don't want to change the file. Will your product support all date formats?

Yes. You can select the specific date format as per your requirements. More Info...

Do you have any sample templates?

Yes. We do have. Sample template for Imports.

What are the file types supported by your application?

 Txt, CSV, xls, xlsx files

How do I report the issues if I am stuck?

Feel free to drop an email to [email protected]

Possible Failures & Troubleshooting Tips

The currency of the transaction is invalid for the customer/vendor/account.

The given Currency is different than the default currency of the vendor. Please refer to the Vendor's Currency in QuickBooks & update the same currency in the Currency Field. It is possible that Multi-Currency feature in QuickBooks could be disabled. Please enable the feature.

Required parameter(s) missing:Line

Please provide at least one Item Line or Expense Account Line Details to process.

Transaction amount (Sum of line amounts) must be 0 or greater.

Please provide the valid (Non-Negative) amounts in Line Item and Expense Amount.

No matching Product/Service found (or) could be created for the provided details.

Please provide a valid name in the Product Field. You might have disabled "Auto Create List Entities" Feature in Import Settings. By enabling this feature, QuickBooks will automatically create the product for the transaction.

Duplicate Document Number Error: You must specify a different number. This number has already been used.

Another Expense has the same reference number. Please use another reference number.

You have disabled "Assign Transaction Numbers from file" in Import Settings. By enabling this feature, QuickBooks will automatically assign numbers for the transaction.

Invalid value for Global Tax Calculation.

Please provide one of the below values 

  • TaxInclusive

  • TaxExcluded 

  • NotApplicable

One or more transaction lines do not have a tax code. Please assign a tax code for those lines.

You have mentioned "Global Tax Calculation" as TaxIncluded or Tax Excluded, but the Tax code is missing for the line items. Please change the "Global Tax Calculation" to "NotApplicable" or provide a valid Tax Code for each line item.

No matching reference was found for this account.

Please provide a valid Expense account name in the "Account" field.

Invalid account type: You need to select a different type of account for this transaction.

Please provide a valid Expense account name in the "Account" field.

Amount is missing in the request.

The Line Item amount is missing for the particular line item.

Required parameter Line Amount is missing in the request.

The Line Item amount is missing for the particular line item.

Please check in QuickBooks company settings if the appropriate preferences are enabled for the successful upload of current data set. E.g: Shipping, Multi-Currency, etc.

If you have provided Shipping Address or Currency, then please make sure you have enabled "Shipping & Multi-Currency" feature in QuickBooks Online.

Requested entity/feature (Billable Expense) is not supported by QuickBooks per your subscription.

Billable Customer or Expense feature is not available for your QuickBooks Online Subscription. Please remove the values in Billable Fields (Expense Billable, Line Item Billable)

No matching reference found for this customer.

There is no match found for given Customer Name.

Please enable "Auto Creation of List Entities (Vendor, Customer)" feature in import settings to create the customer automatically.

No matching vendor found (or) could be created for the provided details.

There is no match found for given Vendor Name.

Please enable "Auto Creation of List Entities (Vendor, Customer)" feature in import settings to create the customer automatically.

If the currency field has some value, Please enable Multi-Currency feature in QuickBooks.

Business Validation Error: There is no account associated with the item "XXXXX". Is it marked for purchase, and has an account associated with it?

Please assign the Expense Account for Product / Service "XXXXX" in your QuickBooks Online.

Business Validation Error: You must select a customer for each split line that is billable.

Please enable the below features in your QuickBooks Online.

  • Track expenses and items by customer

  • Make expenses and items billable

How to Import Checks into QuickBooks Online (New User Interface 2.0)

1) Login into SaasAnt Transaction Online


2) Select the New Import Tab.

3)  Select TransactionList, or Attachment to upload your file into QuickBooks.

4) Select the QuickBooks entity as "Checks".

5) Select the files you want to upload.


6)  Set up the Mapping of the columns in your Checks.

7) Select the "Preview Mapping" button to visualize current mapping based on QuickBooks.


8) Select the "Review" button to view the mapped Excel data according to the QuickBooks file headers.

9) Select the Upload tab.

10) The data was imported successfully into Quickbooks.

Let’s have a look at the SaasAnt Transactions Online Fields.

SaasAnt Transactions (Online) Fields


Field Name

Format

Description

Check No

21 Characters

Reference number for the transaction.

Payee

Characters

Name of the vendor / Customer / Employee for this transaction.

Account

Characters

Name of the Account for this transaction.

Payment Date

Date

The date entered by the user when this transaction occurred.

Memo

4000 Characters

The Note about the Bill Transaction.

Mailing Address Line 1

500 Characters

First line of the address.

Mailing Address Line 2

500 Characters

Second line of the address.

Mailing Address Line 3

500 Characters

Third line of the address.

Mailing Address City

255 Characters

City name.

Mailing Address Postal Code

31 Characters

Postal code (zip code for USA and Canada).

Mailing Address Country

255 Characters

Country name

Mailing Address Country Sub Division Code

255 Characters

Region within a country

Global Tax Calculation

Characters

Method in which tax is applied.

  • TaxExcluded

  • TaxInclusive

  • NotApplicable

Expense Account

Characters

Reference to the Expense Account Name associated with the billing.

Expense Description

4000 Characters

Free form text description of the Expense.

Expense Line Amount

Decimal

The amount of the line item.

Expense Billable Status

Boolean

The billable status of the expense.
TRUE if Billable, FALSE If Not Billable.

Expense Markup Percent

Decimal

The Markup value in Percentage for the expense.

Expense Customer

Characters

Reference to the Customer associated with the expense.

Expense Class

Characters

Reference to the Class for the Expense.

Expense Tax Code

Characters

Reference to the Purchase Tax Code

Expense Account Tax Amount

Decimal

The  calculated tax amount for an Expense Account line . Applicable only for Tax calculated Transactions. This value will be ignored for Tax Inclusive Transactions.

Line Item
or
Product/Service

Characters

Reference to the Item.

Line Item Description
or
Product/Service

4000 Characters

Description of the Item. It will be populated from Item description entered in QuickBooks Online.

Line Item Quantity
or
Product/Service Quantity

Decimal

The Quantity of the Item.

Line Item Rate
or
Product/Service Rate

Decimal

The Unit Price of the Item.

Line Item Amount
or
Product/Service Amount

Decimal

The Total Amount of the Item. Not required if Line Item Quantity & Line Item Rate is present.

Line Item Billable Status
or
Product/Service Billable Status

Boolean

The billable status of the Item.
TRUE if Billable, FALSE If Not Billable.

Line Item Tax Code
or
Product/Service Tax Code

Characters

The purchase tax code for the line Item.

Line Item Tax Amount
or
Product/Service Tax Amount

Decimal

The  calculated tax amount for a product line . Applicable only for Tax calculated Transactions. This value will be ignored for Tax Inclusive Transactions.

Line Item Markup Percent
or
Product/Service Markup Percent

Decimal

The Markup value in Percentage for the Item.

Line Item Customer
or
Billable Customer:Product/Service

Characters

The Customer name for the Item.

Line Item Class
or
Product/Service Class

Characters

The Class name for the Item.

Location

Characters

The location of the transaction.

Currency Code

Characters

The Currency Code for this transaction.

Exchange Rate

Decimal

The exchange rate of the given currency against the home currency.

Print Status

Boolean

TRUE / FALSE
T/F
Y/N

FAQ's

Most of us would have some questions while moving data to your QuickBooks Online. Some of them for your reference below:

  • Will your application support Multi Line Transactions?

Yes. It will. More Info...

  • I made some mistakes in the mapping. Your application imported wrongly. So my QuickBooks file got corrupted. Is there any way to undo or revert?

Sometimes it happens due to the wrong mapping. It is possible to delete the entire transactions which went wrong. Our DELETE feature is the rescue. More Info...

  •  I want to import Checks using SKU's. Is it supported?

Yes. It is. You need to enable couple of settings while importing. More Info...

  • I want to get an email for each upload. Is it possible?

Yes. It is. You need to enable couple of settings while importing. More Info...

  • Does your app support taxes?

Yes. It does. Tax model.

  • I don't want to create products automatically for my invoices. I can't create products before each upload. Is it supported?

Yes. It is. You need to enable couple of settings while importing. However. you can control this behavior. More Info...

  • My file has some specific date format. I don't want to change the file. Will your product support all date formats?

Yes. You can select the specific date format as per your requirement. More Info...

  • Do you have any sample templates?

Yes. We do have. Sample template for Imports.

  • What are the file types supported by your application?

    txt, csv, xls, xlsx files

Possible Failures & Troubleshooting Tips


The currency of the transaction is invalid for customer / vendor / account.

The given Currency is different than the default currency of the vendor. Please refer the Vendor's Currency in QuickBooks & update the same currency in Currency Field. It is possible that Multi-Currency feature in QuickBooks could be disabled. Please enable the feature.


Required parameter(s) missing:Line

Please provide at least one Item Line details or Expense Account Line Details to process.


Transaction amount (Sum of line amounts) must be 0 or greater.

Please provide the valid (Non Negative) amounts in Line Item Amount and Expense Amount.


No matching Product/Service found (or) could be created for the provided details.

Please provide valid name in Product Field. You might have disabled "Auto Create List Entities" Feature in Import Settings. By enabling this feature, QuickBooks will automatically create the product for the transaction.


Duplicate Document Number Error : You must specify a different number. This number has already been used.

There is an another Expense has the same reference number. Please use the another reference number.

You have disabled "Assign Transaction Numbers from file" in Import Settings. By enabling this feature, QuickBooks will automatically assign numbers for the transaction.


Invalid value for Global Tax Calculation.

Please provide one of the below values 

  • TaxInclusive

  • TaxExcluded 

  • NotApplicable


One or more transaction lines do not have a tax code associated with it. Please assign a tax code for those line.

You have mentioned "Global Tax Calculation" as TaxIncluded or Tax Excluded, but the Tax code is missing for the line items. Please change the "Global Tax Calculation" as "NotApplicable" or provide valid Tax Code for each line items.


No matching reference found for this account.

Please provide valid Expense account name in "Account" field.


Invalid account type: You need to select a different type of account for this transaction.

Please provide valid Expense account name in "Account" field.


Amount is missing in the request.

The Line Item amount is missing for the particular line item.


Required parameter Line Amount is missing in the request.

The Line Item amount is missing for the particular line item.


Please check in QuickBooks company settings if the appropriate preferences are enabled for the successful upload of current data set. E.g: Shipping, Multi-Currency, etc.

If you have provided Shipping Address or Currency, then please make sure you have enabled "Shipping & Multi-Currency" feature in QuickBooks Online.


Requested entity/feature (Billable Expense) is not supported by QuickBooks per your subscription.

Billable Customer or Expense feature is not available for your QuickBooks Online Subscription. Please remove the values in Billable Fields (Expense Billable, Line Item Billable)


No matching reference found for this customer.

There is no match found for given Customer Name.

Please enable "Auto Creation of List Entities (Vendor, Customer)" feature in import settings to create the customer automatically.


No matching vendor found (or) could be created for the provided details.

There is no match found for given Vendor Name.

Please enable "Auto Creation of List Entities (Vendor, Customer)" feature in import settings to create the customer automatically.

If the currency field has some value, Please enable Multi-Currency feature in QuickBooks.


Business Validation Error: There is no account associated with the item "XXXXX". Is it marked for purchase, and has an account associated with it?

Please assign the Expense Account for Product / Service "XXXXX" in your QuickBooks Online.


Business Validation Error: You must select a customer for each split line that is billable.

Please enable the below features in your QuickBooks Online.

  • Track expenses and items by customer

  • Make expenses and items billable

Automated data Import / Export to QuickBooks Online
Say goodbye to the hassle of managing transactions manually
Grow exponential with Clear Financial Visibility