E-File Magic

Other workflows

Import from QuickBooks Desktop

Connect your company with the Windows app, map accounts, and review the local preview before uploading.

Illustration of a desktop computer, a local spreadsheet file and a cable leading to a blue import tray.
In this guide

Need another verification method?

Use your profile on the website to manage your verification methods, then return to password sign-in in the Windows app.

Read profile and security help

Before you start

Windows 10 or 11, 64-bit

Use the current importer for the same E-File Magic environment.

A US QuickBooks company in USD

QuickBooks Desktop must be installed locally.

Permission for read-only access

Keep the company unchanged while collection finishes.

View all setup requirements
  • The application is named E-File Magic Desktop Importer. Its Windows shortcut is E-File Magic Importer - Dev, Staging or Prod. Versions before 0.1.5 require one manual upgrade using the installer for the same environment. Newer installed versions check for updates at startup. Saved import recovery data is retained and setup leaves unchanged application files in place.
  • Use 64-bit Windows 10 or 11 with a locally available US QuickBooks Desktop installation and USD company.
  • Sign in with an active account role. Have company administrator permission to approve read-only access.
  • Keep your company file unchanged until collection checks finish.
  • Read-only connection means this app reads your QuickBooks company without changing it. Starting an import uploads the selected data to E-File Magic for processing.
  • Review the Terms of Service, Terms of Use and Privacy Policy and confirm the unchecked acceptance box in setup before installation or update.

Connect, review and import

Preview stays on your computer. Start import uploads the reviewed collection.

  1. Install the app and sign in

    Install the current Windows application and sign in.

  2. Connect the intended company

    In Connect company, choose Open company or browse to a .QBW file, approve read-only access, confirm the company and Continue to mapping.

  3. Map accounts for the selected tax year

    In Map accounts, choose the tax year and form fields, then Review import.

  4. Choose import options and preview

    In Import options, choose the destination, minimum vendor total, and whether to include card payments. Pause company edits and select Preview data.

  5. Review the collection and start import

    Review mapped vendor/field totals and any excluded items. Use Back for changes, or Start import to upload the reviewed collection.

  6. Follow processing online

    Use View import online to follow processing and review recipients. Filing and delivery remain separate steps.

A scheduled import continues online after Windows closes.

Page details and controls
Install and review the policies

Open the matching installer

Open setup for the edition matching your website. The welcome page shows the E-File Magic logo and Welcome, Terms & privacy, Install and Finish steps. Select Get started.

Read and accept the policies

Review Terms of Service, Terms of Use and Privacy Policy using the three document buttons and scrollable reader; complete copies are available offline. Open this document online opens the selected policy on www.efilemagic.com/legal/. Select the initially unchecked I agree to the Terms of Service and Terms of Use, and acknowledge the Privacy Policy checkbox to enable Continue. Back keeps your choice during this setup; unchecking blocks Continue again. Cancel exits setup.

Install and finish

Review the installation location and shortcut choices, select Install, then Finish; Open E-File Magic Desktop Importer can launch the app.

Updates require confirmation

Updates and reinstalls require this confirmation again. Silent installation is unavailable. Installation acceptance does not create an account or replace account or order acceptance.

Install an available update

Automatic update checks

Starting with version 0.1.5, the installed app checks for updates each time it opens and downloads a newer version in the background. If an update cannot be checked or downloaded, keep using the app normally; no startup error is shown.

Install when ready

When the app is idle, An update is ready shows the new version. Install and restart opens setup and closes the app; review and accept the policies, install, then Finish to reopen it. The installation location stays the same.

Postpone or cancel

Cancelling setup reopens the existing version. Later, Escape or closing the update dialog keeps working and postpones the prompt until the next startup.

When prompts wait

Updates wait while an import draft, active operation or sign-in challenge is open. Versions before 0.1.5 need one manual installation to enable this feature.

Sign in and account setup

Sign in to the Windows app

The slim sign-in window appears first. Enter Email and Password, then Sign in. Show password and Hide password toggle the eye control; switching away masks the password, and signing in clears it. The full import interface opens after sign-in succeeds.

Choose and complete your account

Choose an account and Continue when offered. Complete required first/last name, contact phone, address lines, city, state, ZIP and country, then Save and continue.

Supported sign-in options

This importer uses your email and password and does not offer browser sign-in or passkeys. An organization-only account needs a local password permitted by its organization. Verification methods depend on your account policy. Forgot password? and Create account open the corresponding website.

Verify your sign-in

Choose an available method

After sign-in, Verify it's you shows large Authenticator App, Text Message, and Email Code tiles for the methods available to your account. Choose a tile to open its next step; the tiles leave the screen.

Email or text-message code

Email Code and Text Message request a code and open a separate code page. Enter the latest six-digit code and choose Verify and continue. Wait for the countdown before using Send code or Resend code.

Authenticator app

An enrolled Authenticator App opens code entry directly. If setup is required, first scan the QR code or expand Can't scan? Enter the setup key. Set up authenticator retries setup; Generate new QR code replaces it. Choose I've added it to open code entry, or Back to setup to see the QR again.

Change method or start again

Choose another method returns to the tiles and clears entered codes, while keeping the resend countdown. Back to sign in on the tile page starts over; Cancel operation stops an active request. Verification must succeed before you continue.

If you need another verification method

Email remains available when your account policy allows it. Accounts requiring MFA use an authenticator or configured text-message verification; email cannot bypass that requirement. If your account currently offers only passkeys, add an authenticator or text-message verification method to your account on the website, then sign in here again. Back to sign in lets you use another account; contact support if you cannot access yours.

Choose an action

Return to imports

Imports and Back to imports return to local import actions when idle, closing the QuickBooks connection and clearing the visible draft.

Follow the four-step workflow

Import from QuickBooks Desktop opens four steps: Connect company, Map accounts, Import options, then Preview & import. The continuous blue progress panel marks completed steps with green checkmarks. The footer stays visible while content scrolls. Back preserves settings; Back from preview removes that collected preview so the next preview is fresh.

Get contextual help

Help or F1 opens an offline help panel for the current screen. Search help, choose a topic, or select Help for this screen. Close or Escape returns to your work. Help remains available during collection and upload without stopping them; Website opens E-File Magic.

Account and window controls

The account menu contains Sign out, Discard local collection and Open diagnostic logs. The environment badge identifies the installed app and cannot switch environments. Sign out returns to the slim login. Minimize and Maximize or restore use normal Windows behavior.

Step 1: Connect company

Choose the company

In step 1, choose the Open company tile to use the company open in QuickBooks. Choose a company file and Browse files let you select a .QBW file instead; cancelling the file picker leaves your choice unchanged.

Approve read-only access

Connect company asks QuickBooks for read-only access. Open QuickBooks and approve the request, then confirm the displayed company name and file before choosing Continue to mapping.

Change company and connection options

Change company disconnects and clears the old company details and mappings. Connection options says Compatibility is selected automatically. Leave the default enabled; Always use the 32-bit QuickBooks connection forces that option when support recommends it. This setting is about the connection component and is not limited to older QuickBooks editions.

Check supported company requirements

QuickBooks Desktop must be installed locally. This screen does not list every company automatically; open the intended company or browse to its file. Unsupported edition, currency, missing company EIN or unavailable QuickBooks prevents collection.

Step 2: Map accounts

In step 2, choose Tax year and select a form field for each account to include. The account count shows how many are mapped; unmapped accounts are excluded. The × control clears that account mapping. Map at least one account to continue; hundreds or thousands of mappings are supported within the configuration capacity. Changing the year clears mappings and the previous destination choice; form fields and eligible filers follow the selected year. Back returns to the connected company without losing mappings or reconnecting.

Step 3: Import options

Choose a new or existing filer

In step 3, confirm the company, tax year and mapped-account count. Choose Create a new filer to review its legal company name, EIN, street, city, state and ZIP, with required contact name and phone and optional email. Choose Use an existing filer to select a compatible unlocked filer for the chosen year.

Search for another filer

Find another filer expands search; enter a name and choose Find filers, then select a destination. Load more filers appears when another page is available.

Set payment filters

Enter Minimum vendor total in dollars with at most two decimal places. Include card payments is off by default; confirm the appropriate treatment before enabling it.

Validate fields and preview

Back returns to mappings and preserves these settings. Select Preview data to collect and review before uploading. Required fields have an asterisk. Address line 2 and contact email are optional. Field errors appear beneath the affected input when you leave it or choose Preview data; correcting the value clears its error. Preview data focuses the first invalid field. Field rules follow the selected year. These input errors are separate from operational failures.

Step 4: Preview & import

Review totals and preview rows

In step 4, review up to the first 50 mapped vendor and form-field totals. The table shows vendor name, masked Tax ID, form, mapped field, amount and source accounts. Long values wrap and have tooltips; resize or sort columns and scroll as needed. The vendor count and mapped total include the full collection, not just the displayed rows.

Check exclusions and estimates

Expand Excluded items and review notes to inspect filtered or unsupported items. An empty preview explains how to check the year, account mappings, minimum total, card options and vendor 1099 eligibility. Some partial-payment cent allocations may be marked as estimates; E-File Magic confirms them online.

Change options and refresh the preview

Back returns to options and removes the old preview; select Preview data again after changing settings.

Review mailing addresses

The preview also shows each mailing address. The importer reads structured QuickBooks fields and mailing blocks, removes matching company/contact headings, and recognizes US city/state/ZIP and secondary lines. Review flagged or ambiguous addresses in QuickBooks and collect again. Original collected records remain protected locally.

Review and dismiss an error

Operational errors appear in a dismissible banner above the import workspace. Diagnostic details is collapsed by default; expand it for the reference, operation and available status information. The smaller Open diagnostic logs link opens the local folder, also available from the account menu. Redacted logs include request/operation outcomes, timing, source progress and correlation IDs without company records, payment values, query text, signed URLs or credentials. Share the reference and relevant log when requesting help. Dismiss preserves selections and does not retry. Correct ordinary input errors beneath their fields.

Collect, then confirm upload

Preview data on step 3 collects and checks QuickBooks data locally without uploading. Keep QuickBooks open and pause company edits until these checks finish. Start import on step 4 sends the full collection and settings you reviewed, then schedules processing. Navigation is disabled while busy; Cancel operation stops local work. Closing cancels active work and waits for cleanup. Once scheduled, View import online opens progress and the Windows app can close. E-File Magic validates recipient details and processes the complete collection online. Filing and delivery remain separate actions.

Resume or discard

Resume upload on the home card or paused-import screen resumes a collection already confirmed with Start import for the same account and skips accepted pages. An interrupted collection or a preview that was never confirmed must be discarded and collected again. Use Discard collection on the paused screen or Discard local collection in the account menu. Saved collections expire after seven days. Discard removes local recovery data and returns to imports; it does not cancel a server import already scheduled. Resuming a scheduled collection shows its saved receipt without creating another import.

Download and review online

Get the matching Windows installer

Choose Get the app on the QuickBooks Desktop tile to open download instructions without leaving Accounting integrations. Download for Windows downloads the installer matching this website; it requires Windows 10 or 11 (64-bit), a US QuickBooks Desktop company and USD.

Publisher and installer details

Signed releases identify the Windows publisher as SCMB, LLC. Development packages may be unsigned; signing does not guarantee that Windows SmartScreen will show no warning.

Return to the provider or import

Close, the close icon, the backdrop or Escape dismisses the dialog and returns focus to its launcher. On an import results page, Get the Windows app opens the same dialog. All integrations returns to the provider directory, and Import history opens saved Desktop imports. Refresh progress updates the saved status; Import details expands the reference and counts.

Open completed import results

Completed imports show a compact summary and View recipients opens the destination filer. Import results loads saved row outcomes automatically after completion or failure. These explain skipped records, preserved edits and possible duplicates; they do not collect more QuickBooks data.

Reload or page through outcomes

Refresh results reloads the current page; Previous and Next move through pages of up to 25 records. Try again retries a failed read without restarting the import. Reasons are visible on each row; Record details expands references, and Compare values toggles saved field comparisons. Review recipient candidate links open possible duplicates without merging them. Empty results stay quiet. When temporary details have expired, totals and imported recipients remain available.

Find an earlier import

In Accounting integrations, open Import history to find a scheduled Desktop import. Choose QuickBooks Desktop in Integration and optionally filter by Status. Refresh history updates the list; Previous and Next change pages. View progress opens an active import, and View results opens a completed or failed import. The All integrations view also includes your online accounting imports.

Get help in the app

Help or F1 opens an offline help panel for the current screen. Search help, choose a topic, or select Help for this screen. Close or Escape returns to your work. Help remains available during collection and upload without stopping them; Website opens E-File Magic.

Review QuickBooks mailing addresses

The preview also shows each mailing address. The importer reads structured QuickBooks fields and mailing blocks, removes matching company/contact headings, and recognizes US city/state/ZIP and secondary lines. Review flagged or ambiguous addresses in QuickBooks and collect again. Original collected records remain protected locally.

Actions and controls
  • Wait for the saved sign-in check when the app starts; sign-in and import actions become available when it finishes. If the app locks or your account changes, company details and selections are cleared and QuickBooks disconnects. Sign in again to return to actions, then reconnect or resume a finished collection belonging to that same account.
  • The slim sign-in window appears first. Enter Email and Password, then Sign in. Show password and Hide password toggle the eye control; switching away masks the password, and signing in clears it. The full import interface opens after sign-in succeeds. Choose an account and Continue when offered. Complete required first/last name, contact phone, address lines, city, state, ZIP and country, then Save and continue. This importer uses your email and password and does not offer browser sign-in or passkeys. An organization-only account needs a local password permitted by its organization. Verification methods depend on your account policy. Forgot password? and Create account open the corresponding website.
  • After sign-in, Verify it's you shows large Authenticator App, Text Message, and Email Code tiles for the methods available to your account. Choose a tile to open its next step; the tiles leave the screen. Email Code and Text Message request a code and open a separate code page. Enter the latest six-digit code and choose Verify and continue. Wait for the countdown before using Send code or Resend code. An enrolled Authenticator App opens code entry directly. If setup is required, first scan the QR code or expand Can't scan? Enter the setup key. Set up authenticator retries setup; Generate new QR code replaces it. Choose I've added it to open code entry, or Back to setup to see the QR again. Choose another method returns to the tiles and clears entered codes, while keeping the resend countdown. Back to sign in on the tile page starts over; Cancel operation stops an active request. Verification must succeed before you continue. Email remains available when your account policy allows it. Accounts requiring MFA use an authenticator or configured text-message verification; email cannot bypass that requirement. If your account currently offers only passkeys, add an authenticator or text-message verification method to your account on the website, then sign in here again. Back to sign in lets you use another account; contact support if you cannot access yours.
  • Imports and Back to imports return to local import actions when idle, closing the QuickBooks connection and clearing the visible draft. Import from QuickBooks Desktop opens four steps: Connect company, Map accounts, Import options, then Preview & import. The continuous blue progress panel marks completed steps with green checkmarks. The footer stays visible while content scrolls. Back preserves settings; Back from preview removes that collected preview so the next preview is fresh. Help or F1 opens an offline help panel for the current screen. Search help, choose a topic, or select Help for this screen. Close or Escape returns to your work. Help remains available during collection and upload without stopping them; Website opens E-File Magic. The account menu contains Sign out, Discard local collection and Open diagnostic logs. The environment badge identifies the installed app and cannot switch environments. Sign out returns to the slim login. Minimize and Maximize or restore use normal Windows behavior.
  • In step 1, choose the Open company tile to use the company open in QuickBooks. Choose a company file and Browse files let you select a .QBW file instead; cancelling the file picker leaves your choice unchanged. Connect company asks QuickBooks for read-only access. Open QuickBooks and approve the request, then confirm the displayed company name and file before choosing Continue to mapping. Change company disconnects and clears the old company details and mappings. Connection options says Compatibility is selected automatically. Leave the default enabled; Always use the 32-bit QuickBooks connection forces that option when support recommends it. This setting is about the connection component and is not limited to older QuickBooks editions. QuickBooks Desktop must be installed locally. This screen does not list every company automatically; open the intended company or browse to its file. Unsupported edition, currency, missing company EIN or unavailable QuickBooks prevents collection.
  • In step 2, choose Tax year and select a form field for each account to include. The account count shows how many are mapped; unmapped accounts are excluded. The × control clears that account mapping. Map at least one account to continue; hundreds or thousands of mappings are supported within the configuration capacity. Changing the year clears mappings and the previous destination choice; form fields and eligible filers follow the selected year. Back returns to the connected company without losing mappings or reconnecting.
  • In step 3, confirm the company, tax year and mapped-account count. Choose Create a new filer to review its legal company name, EIN, street, city, state and ZIP, with required contact name and phone and optional email. Choose Use an existing filer to select a compatible unlocked filer for the chosen year. Find another filer expands search; enter a name and choose Find filers, then select a destination. Load more filers appears when another page is available. Enter Minimum vendor total in dollars with at most two decimal places. Include card payments is off by default; confirm the appropriate treatment before enabling it. Back returns to mappings and preserves these settings. Select Preview data to collect and review before uploading. Required fields have an asterisk. Address line 2 and contact email are optional. Field errors appear beneath the affected input when you leave it or choose Preview data; correcting the value clears its error. Preview data focuses the first invalid field. Field rules follow the selected year. These input errors are separate from operational failures. New filers created in this accounting workflow need a United States address. Choosing an existing filer does not ask you to re-enter its address or supply a new US ZIP code.
  • Preview data on step 3 collects and checks QuickBooks data locally without uploading. Keep QuickBooks open and pause company edits until these checks finish. Start import on step 4 sends the full collection and settings you reviewed, then schedules processing. Navigation is disabled while busy; Cancel operation stops local work. Closing cancels active work and waits for cleanup. Once scheduled, View import online opens progress and the Windows app can close. E-File Magic validates recipient details and processes the complete collection online. Filing and delivery remain separate actions.
  • Resume upload on the home card or paused-import screen resumes a collection already confirmed with Start import for the same account and skips accepted pages. An interrupted collection or a preview that was never confirmed must be discarded and collected again. Use Discard collection on the paused screen or Discard local collection in the account menu. Saved collections expire after seven days. Discard removes local recovery data and returns to imports; it does not cancel a server import already scheduled. Resuming a scheduled collection shows its saved receipt without creating another import.
  • Choose Get the app on the QuickBooks Desktop tile to open download instructions without leaving Accounting integrations. Download for Windows downloads the installer matching this website; it requires Windows 10 or 11 (64-bit), a US QuickBooks Desktop company and USD. Signed releases identify the Windows publisher as SCMB, LLC. Development packages may be unsigned; signing does not guarantee that Windows SmartScreen will show no warning. Close, the close icon, the backdrop or Escape dismisses the dialog and returns focus to its launcher. On an import results page, Get the Windows app opens the same dialog. All integrations returns to the provider directory, and Import history opens saved Desktop imports. Refresh progress updates the saved status; Import details expands the reference and counts. Completed imports show a compact summary and View recipients opens the destination filer. Import results loads saved row outcomes automatically after completion or failure. These explain skipped records, preserved edits and possible duplicates; they do not collect more QuickBooks data. Refresh results reloads the current page; Previous and Next move through pages of up to 25 records. Try again retries a failed read without restarting the import. Reasons are visible on each row; Record details expands references, and Compare values toggles saved field comparisons. Review recipient candidate links open possible duplicates without merging them. Empty results stay quiet. When temporary details have expired, totals and imported recipients remain available.
  • In Accounting integrations, open Import history to find a scheduled Desktop import. Choose QuickBooks Desktop in Integration and optionally filter by Status. Refresh history updates the list; Previous and Next change pages. View progress opens an active import, and View results opens a completed or failed import. The All integrations view also includes your online accounting imports.
  • Starting with version 0.1.5, the installed app checks for updates each time it opens and downloads a newer version in the background. If an update cannot be checked or downloaded, keep using the app normally; no startup error is shown. When the app is idle, An update is ready shows the new version. Install and restart opens setup and closes the app; review and accept the policies, install, then Finish to reopen it. The installation location stays the same. Cancelling setup reopens the existing version. Later, Escape or closing the update dialog keeps working and postpones the prompt until the next startup. Updates wait while an import draft, active operation or sign-in challenge is open. Versions before 0.1.5 need one manual installation to enable this feature.
  • In step 4, review up to the first 50 mapped vendor and form-field totals. The table shows vendor name, masked Tax ID, form, mapped field, amount and source accounts. Long values wrap and have tooltips; resize or sort columns and scroll as needed. The vendor count and mapped total include the full collection, not just the displayed rows. Expand Excluded items and review notes to inspect filtered or unsupported items. An empty preview explains how to check the year, account mappings, minimum total, card options and vendor 1099 eligibility. Some partial-payment cent allocations may be marked as estimates; E-File Magic confirms them online. Back returns to options and removes the old preview; select Preview data again after changing settings. The preview also shows each mailing address. The importer reads structured QuickBooks fields and mailing blocks, removes matching company/contact headings, and recognizes US city/state/ZIP and secondary lines. Review flagged or ambiguous addresses in QuickBooks and collect again. Original collected records remain protected locally.
  • Operational errors appear in a dismissible banner above the import workspace. Diagnostic details is collapsed by default; expand it for the reference, operation and available status information. The smaller Open diagnostic logs link opens the local folder, also available from the account menu. Redacted logs include request/operation outcomes, timing, source progress and correlation IDs without company records, payment values, query text, signed URLs or credentials. Share the reference and relevant log when requesting help. Dismiss preserves selections and does not retry. Correct ordinary input errors beneath their fields.
  • Help or F1 opens an offline help panel for the current screen. Search help, choose a topic, or select Help for this screen. Close or Escape returns to your work. Help remains available during collection and upload without stopping them; Website opens E-File Magic.
  • The preview also shows each mailing address. The importer reads structured QuickBooks fields and mailing blocks, removes matching company/contact headings, and recognizes US city/state/ZIP and secondary lines. Review flagged or ambiguous addresses in QuickBooks and collect again. Original collected records remain protected locally.

If you get stuck

QuickBooks will not connect.

Run the importer on the same computer and Windows desktop as QuickBooks. Open the company or use Browse files to select its .QBW file, then approve read-only access. Leave connection compatibility automatic unless support recommends Always use the 32-bit QuickBooks connection. Confirm a US edition and USD home currency.

An upload was interrupted or my session locked.

Sign in to the same account. If you already confirmed the preview with Start import, choose Resume upload. Otherwise discard the unconfirmed or incomplete collection and create a new preview.

Review import is unavailable or my mappings disappeared.

Map at least one account. Larger mapping sets are supported within the configuration capacity; reduce mappings only if the app reports that the configuration is too large. Changing the tax year or using Change company clears old mappings. Back within the wizard preserves them. Back to imports ends the draft.

Review import cannot load the filer requirements.

Your account mappings remain selected. Retry Review import. If the message says the current validation rules are unsupported, install the latest importer for the same environment. Expand diagnostic details for the reference to share with support.

More troubleshooting (8)
The company changed during collection.

Pause edits, discard the interrupted collection, and connect and collect again.

No years, filers or form boxes are available.

Check account permissions and the chosen year. Use Find filers or create a new filer with all required company/contact details.

The download or sign-in request is unavailable.

Download the edition matching your E-File Magic website. Sign in to the importer with your email and password; use Forgot password? for account recovery. Do not change the installed app environment or use an installer from another source.

The connection closes unexpectedly or an older version reports end of stream.

Install the latest importer for the same environment. Reopen the intended company and retry Connect company. Leave connection compatibility automatic unless support recommends the 32-bit override. Open diagnostic logs from the error banner and include its reference when requesting help. A failure before mapping is unrelated to whether a vendor qualifies for reporting.

The source upload fails or reports invalid upload headers.

Install the latest importer for the same environment, then choose Resume upload to continue your confirmed collection. Your saved collection is preserved across the update. If the upload still fails, expand diagnostic details and share the reference with support.

Import results could not be loaded

Choose Try again in Import results. This reloads saved outcomes only. Your imported recipients and completed status remain available.

No supported verification method is available.

Email remains available when your account policy allows it. Accounts requiring MFA use an authenticator or configured text-message verification; email cannot bypass that requirement. If your account currently offers only passkeys, add an authenticator or text-message verification method to your account on the website, then sign in here again. Back to sign in lets you use another account; contact support if you cannot access yours.

Windows could not load the QuickBooks connection component (0x80040154).

Version 0.1.12 tries the included 32-bit connection when the default connection component is unavailable. If neither works, have your administrator repair and update QuickBooks on the computer running the importer. For hosted QuickBooks, run the importer inside the same hosted desktop. Choosing a different company file will not repair this component. Share desktop.log and both quickbooks-bridge logs through support.