Pre Requisites:

Connect your QuickBooks Online account to SaasAnt Transactions (Online) App from QuickBooks AppStore by clicking the "Get App Now" button and get the 30 days free trial [No credit card required].

Please refer basics of field mappings for more info. If you have any questions or concerns, please don't hesitate to contact us at support@saasant.com.

How to Import Checks into QuickBooks Online using SaasAnt Transactions Online

1) Login into SaasAnt Transaction Online

2) Select the Bulk Upload Tab.

3) Select the QuickBooks entity as "Checks".

4) Select the file you want to upload.

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

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

7) Select the Upload tab.

8) The data was imported successfully into QuickBooks.

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

SaasAnt Transactions Online Fields

Checks Settings Reference Guide

The Checks settings panel manages automation rules, date formatting, address updates, and specific general ledger or product lookups utilized exclusively when importing outbound check transactions into QuickBooks.

Global Automation & Core Rules

• Do you want to apply suggestions automatically?

  • What it does: Employs automated matching logic and historical fallback parameters to fill minor data gaps or map close matches, keeping your check import moving smoothly.

• Do you want to create Customers, Vendors, Locations, Classes, and Accounts automatically?

  • What it does: Acts as a master background creation switch. If a check row references a brand-new vendor profile, customer, or account that doesn't exist yet, this allows SaasAnt to build it on the fly to prevent validation errors.

• Do you want to skip the mapping screen?

  • What it does: Streamlines your workflow by completely bypassing the Step 2 mapping screen on future check uploads if you are using a consistent, predefined spreadsheet template.

• Date Format

  • What it does: Configures the system parser to correctly read your transaction date column (e.g., DD/MM/YYYY) so days and months are never accidentally transposed.

Reference Numbers & Processing Controls

• Do you want to use the Transaction Reference Numbers from the uploaded file?

  • What it does: Instructs QuickBooks to record the explicit check numbers or reference strings provided in your spreadsheet instead of overwriting them with native, auto-sequenced reference numbers.

• Do you want to disable the optimisation for the batch import?

  • What it does: Turns off parallel processing in favor of a slower, line-by-line verification import—highly useful for auditing complex expense distributions.

• Do you want to receive alerts/notifications about your automation imports?

  • What it does: Controls background email notifications. When enabled, you will receive a summary breakdown showing exactly how many check transactions successfully processed, how many failed, and why.

• Convert Negative Amounts to Positive

  • What it does: Flips negative expense or payout values in your file to positive numbers during processing to comply with QuickBooks' native structural entry rules for check amounts.

Mapping Overrides & Directory Lookups

• Do you want to Update the address (Customer & Vendor) in QuickBooks from the file?

  • What it does: Overwrites the existing billing or shipping address data saved in your QuickBooks profiles with the fresh address details provided in your check import file.

• Do you want to identify the vendor based on their Account Number?

  • What it does: Tells SaasAnt to track down and match up your supplier check rows using their designated QuickBooks Vendor Account Number rather than text fields.

• Do you want to identify product details from SKU information?

  • What it does: Instructs the system to match any associated line items or products on the check using their unique QuickBooks SKU field rather than relying on Item Name matches.

• Find GL Account by Account Number

  • What it does: Forces SaasAnt to look up and map your bank accounts or expense ledgers using their exact numerical chart of account codes rather than full text account names.

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.

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