This article explains how data from QuickBooks Online is imported into Fyle. You’ll understand what types of accounting dimensions are supported, how import behavior works, and key considerations for a smooth setup.
Prerequisites
You can import fields from QuickBooks Online either:
During initial onboarding (while setting up the integration), or
Later, as and when required.
To import data, first connect your QuickBooks Online account with Fyle. Refer to this guide to connect Fyle with QuickBooks Online.
Supported import fields and dimensions
Fyle supports importing a wide range of dimensions from QuickBooks Online. These fields can be mapped to standard or custom fields in Fyle and are used during expense creation and export.
Dimension | Imported as |
Chart of Accounts | Imported as Categories (no custom mapping) |
Products and Services (Items) | Imported as Categories (no custom mapping) |
Vendors | Imported as Merchants (no custom mapping) |
Customers | Mapped to Project, Cost Center, or Custom Field |
Locations | Mapped to Project, Cost Center, or Custom Field |
Best practice recommended is to map the Project dimension in QuickBooks Online to the Project field in Fyle, as this allows restricting certain projects to specific employees.
Import the Code along with the name for specific fields
In many organizations, different values may share similar names—especially across Projects or Departments. To avoid confusion, Fyle supports importing certain fields in a Code: Name format instead of just the name.
Example:
Instead of seeing Advertisement, users will see 1234: Advertisement in Fyle.
This helps users:
Clearly identify the correct values while creating expenses
Reduce errors during export and mapping
Supported fields:
Chart of Accounts
⚠️ This setting is configured during onboarding and cannot be changed later without raising a support request.
Auto-sync behavior
Fyle regularly syncs data from QuickBooks Online to keep your fields up to date. Most fields are refreshed automatically every 24 hours, but you can also perform a manual sync when needed.
Here’s how each type of field behaves when changes are made in QuickBooks Online (like disabling, renaming, or re-creating values).
Behavior | Chart of Accounts | Vendor (Merchant) | Other Dimensions (Dept, Location, Class, etc.) |
Import rule | Only active values | Only active vendors | Only active values |
Disable in QuickBooks Online | Disabled in Fyle | Removed from merchant options | Disabled in Fyle |
Rename in QuickBooks Online | Old value disabled, new value added | Old value deleted, new value added | Old value disabled, new value added |
Delete & recreate in QuickBooks Online | Record updated with correct internal ID | Record updated with internal ID | Record updated with internal ID |
Manual additions in Fyle | Not applicable | Preserved | Preserved |
Re-import after deletion in Fyle | Will be re-imported if still active | Will not be re-imported | Will not be re-imported |
Tips & best practices
If you’ve made changes in QuickBooks Online, trigger a manual sync in Fyle to ensure updates are reflected immediately.
Always make changes in QuickBooks Online and sync them to Fyle—avoid modifying imported fields directly in Fyle.
Turn on import toggles for all essential fields to keep your data accurate and up to date.
Troubleshooting import issues
Issue | Resolution |
Missing values | Trigger a manual sync. Automated sync runs every 24 hours. |
Field not updating | Try deleting and re-importing the mapping if needed. |
FAQs
Can I selectively import only some account types?
Yes, this is possible. While importing the Chart of Accounts to Fyle, you may select which accounts you want to import.
Need help setting this up? Reach out to us at [email protected], and we’ll be happy to assist you.