Import data
Import from your accounting software
Connect your provider, map paid activity to 1099 forms, and review the import results. Choose the part of the workflow you need help with.

In this guide
Your provider stays read-only
Importing reads accounting activity. Review imported recipients and resolve validation issues before filing.
Before you start
A connected provider
An Account Admin connects the service; active account users can then import.
The company and filing year
Confirm the USD source and the destination filer before importing.
Paid-activity categories
Prepare your account mappings and review the combined vendor threshold.
View all setup requirements
- An account administrator can connect the chosen provider by approving E-File Magic on the provider sign-in screen. Other active account users can import from that connection without administrator access.
- For QuickBooks Online, Xero, Zoho Books, FreshBooks, and Business Central, allow popups for E-File Magic and keep the integration page open while you sign in and approve access in the provider window. Your browser may show that window as a separate tab on a phone.
- Know which provider company and filing year you intend to import.
- Confirm the source has valid USD authority; E-File Magic does not convert accounting currencies. BILL verifies USD on each bill and payment instead of claiming an organization home currency.
- Know which paid-expense accounts or categories belong in the supported 1099 boxes.
- If using an existing filer, make sure it is an active 1099 filer for the same year and is not locked by another recipient workflow.
- The inline Create new filer option is for a U.S. business with an EIN and U.S. address. You can enter missing provider details during review. Set up individual or foreign filers in Filers before starting this import.
- For Zoho Books, know the data center shown in your Zoho Books URL or account settings.
- In BILL, open the company you want to import. Use your BILL sign-in email in BILL email address. Copy Organization ID from the bottom of Settings > Sync & Integrations > Manage Developer Keys. Open Settings > Sync & Integrations > Tokens, click NEW, name and save the token, and copy the generated value into AP/AR sync token in E-File Magic. Use values from the same company. If these settings are unavailable, ask your BILL administrator for access.
- For Xero, connect a user who can read the organization’s contacts, accounts, bills, payments, and bank transactions. Have your vendor tax information available to decide which candidates should receive forms. This import does not require the Xero 1099 report.
- For Business Central, ask your administrator to install the E-File Magic Payables extension in the selected environment, assign EFM Payables Read to the dedicated integration user, and complete the required sandbox approval. Reconnect or refresh companies after installation or permission changes; a successful connection alone is not enough.
- Imported recipients with correctable validation errors are saved and marked invalid. Open the recipient and review Validation Issues, correct the information, and save before submitting it for filing. Manual creation and edits must pass validation. Rows that cannot be safely assigned or saved are still skipped; review their diagnostics before importing again.
Choose a part of the workflow
Follow these in order for your first import, or return to a saved run.
Connect your provider
Account Admin task used before company selection or when a saved connection needs authorization again. Ordinary account users can run imports after the connection exists.
Open the provider
Open Recipients, Imports, then Integrations and select the provider tile.
Authorize the connection
For Zoho Books, select United States, Europe, India, Australia, Japan, Canada, China, Saudi Arabia, or United Kingdom to match the organization before clicking Connect or Reconnect.
For QuickBooks Online, Xero, Zoho Books, FreshBooks, or Business Central, click Connect and finish provider sign-in and consent in the popup. Keep the integration page open; the popup closes and the connection list refreshes when authorization succeeds.
Connecting BILL? Use these instructions
In BILL, open the company you want to import. Use your BILL sign-in email in BILL email address. Copy Organization ID from the bottom of Settings > Sync & Integrations > Manage Developer Keys. Open Settings > Sync & Integrations > Tokens, click NEW, name and save the token, and copy the generated value into AP/AR sync token in E-File Magic. Use values from the same company. If these settings are unavailable, ask your BILL administrator for access. Click Connect BILL organization. The first connection shows the form. After connecting, the form closes and your saved connection is selected. Click Continue to company. To connect an additional company, click Connect another organization; Cancel returns to your connections and clears the inputs. Reconnect opens fresh fields for that saved connection; Cancel reconnect returns to the connections list. The token field clears after every attempt. If the request fails, correct the email or organization ID as needed and paste the token again.
Wait for company discovery
Wait until discovery changes from Discovering companies to Connected.
Reconnect or refresh when needed
If a connection needs attention, use Reconnect; use Refresh companies when provider access changed.
A read-only connection is available and its external companies can be selected.
Choose a company and map accounts
Use this to identify the exact provider company and reportable paid-activity categories.
Choose the connection and company
Select one connected grant and click Continue.
Select one active source with valid USD authority and click Continue. For BILL, review the USD verified per record notice.
Review the year and threshold
Choose the filing year and review the Combined vendor threshold. The suggested import filter is $2,000.00 for 2026 when an enabled mapping uses 1099-NEC; otherwise it is $600.00. It applies to combined NEC and MISC totals. Review and adjust it for your import; it is not a substitute for form and box reporting rules.
Map reportable paid activity
Search accounts, enable each account to use, and choose its 1099 form and an amount box offered for the selected year.
For Xero, use the accounts behind paid bills and direct spending; only candidates meeting your mapped totals and threshold will be offered for selection.
Complete enabled mappings
Complete every enabled row or clear it, then click Continue.
The import has one verified USD source and a complete account-mapping plan.
Import and review results
Use this after source and mapping choices are complete.
Choose or create the destination filer
Choose Create new filer and review the legal name, EIN, contact email, required Contact name and Filer phone number, and address. Enter or correct incomplete provider details here; missing BILL tax-ID or account types do not disable this option. Alternatively, search and page through compatible existing filers before selecting one.
Review the complete setup
Review every source, year, mapping, threshold, destination, email, and limitation item.
Start the import or select Xero vendors
Click Start import once, or Prepare vendor list for Xero. When Xero finishes reading payments, select the vendors you need and click Import selected vendors.
Monitor progress and handle interruptions
Watch the phase and counters or leave and return later. If the import fails, review its notice at Connect, choose new settings, and explicitly launch a new run.
If asked, click Reconnect and resume same import, restore the exact saved grant, and wait while E-File Magic verifies the recorded company and resumes that submission. Complete this before the displayed evidence deadline; do not launch a duplicate. Delayed and rate-limited imports resume automatically.
Read diagnostics and compare possible duplicates
After completion, review the automatically loaded Import results. Use Previous and Next to page through records, Refresh results to reload this page, and Try again after a failed read. Read each saved reason; expand Record details or Compare values when needed.
When Review recipient links are shown for a likely duplicate, click each one, compare the possible match under the same filer, and decide what follow-up is needed. If no link is shown, the earlier candidate no longer exists under that filer. Opening a link does not merge or change recipient data.
Eligible cash-paid 1099 activity is applied durably while protected local edits and prior recipients remain intact.
Return to an earlier import
Use the history tab to review seasonal work without starting another import.
Open and filter Import history
Open Accounting integrations and choose Import history for all services, or open a provider and choose its Import history tab.
Use Integration on the all-services page or Status to narrow the list. Refresh history reloads the current page. Previous and Next move through older results; an empty page may still offer Next.
Resume or review the saved run
Use Resume vendor review for an unexpired Xero selection, View progress for active work, or View results for a finished or expired run. Opening history does not launch an import.
Back to import history returns to the list. New import opens a fresh setup after viewing a saved run.
Review retained results after source details expire
After 48 hours, review the saved counts and imported recipients. Start a new import if the source details have expired.
Saved results remain useful for seasonal work while temporary details and resume actions expire.
Page details and controls
Provider Directory
The page has one Accounting integrations heading. A shared strip explains read-only access and supported 1099 forms. Provider tiles show a logo, short description, connection status and one action. Account Admins use Connect when no usable connection exists and Manage when a connection is available or needs attention; other account users use Review or Import. Opening a tile does not authorize a connection or start an import. Available company counts appear as small text instead of empty counters. Needs reauthorization and Connection error can both appear when saved connections need attention. Sample data appears above the grid only when all listed services use samples; otherwise it labels individual sample services. Availability loads automatically when you enter or return to this page. If loading fails, use Try again. A disabled action means the service is not configured or enabled; contact support for help. If no services are listed, the page explains that none are available. All integrations on a provider page returns here without changing provider data. Counts include connected authorizations and their available companies. Disconnected authorizations remain in the provider Connect step but do not inflate the tile counts. Import history remains separate from the provider tiles.
QuickBooks Desktop download
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.
Step 1 - Connections
Every active account user can select a connected grant, refresh the list, refresh company discovery, and continue into an import. Account Admins may also connect another provider, reconnect a failed grant, or disconnect with confirmation. QuickBooks Online, Xero, Zoho Books, FreshBooks, and Business Central open a small sign-in popup while this page waits. The popup closes after authorization and the saved connection updates here. Close, Cancel, a backdrop click, or Escape dismisses an idle disconnect dialog without changing the connection. Discovery progress, connected actor and date, last verification, and redacted errors remain visible. Connecting or refreshing starts company discovery automatically. Disconnect immediately prevents further use of the saved credentials while cleanup finishes. The list updates pending work automatically; Refresh list also checks its progress without creating another connection. Connection cards show company names when loaded, with a short reference for distinction. Finding companies and Disconnecting update automatically. Use Check status to request a fresh status check without restarting discovery. Continue to company stays disabled until the selected connection is Connected. Disconnected cards offer Reconnect, which starts a new connection; reauthorization restores an existing eligible connection. For BILL, open Where to find your BILL connection details for copying instructions. The first connection shows the form. After connecting, the form closes and your saved connection is selected. Click Continue to company. To connect an additional company, click Connect another organization; Cancel returns to your connections and clears the inputs. Reconnect opens fresh fields for that saved connection; Cancel reconnect returns to the connections list. The token field clears after every attempt. Active and attention-needed connections appear first. Disconnected connections is a collapsed list of old authorizations; expand it to view or reconnect. Repeated imports can use the same connected company. A disconnected authorization cannot be selected for a new import.
Step 2 - Source Company
First select a saved connection, then choose one active external company loaded only from that connection. Same-named companies remain distinguishable by provider reference and connection. Business Central also shows the verified environment. Most sources show verified home currency; BILL shows USD verified per record and explains that any bill or payment without its own USD proof is excluded. An invalid-currency-authority, inaccessible, empty, loading, or failed source cannot continue. Refresh companies checks the selected connection again. While discovery runs, use Check status or wait for automatic updates; Continue to mapping becomes available when discovery finishes and a valid company is selected.
Step 3 - Year and Mapping
Select a supported year and combined-vendor threshold. Search provider accounts, enable the accounts to use, and choose a form and amount box for each. Clear removes mappings; Reset suggestions restores suggestions. Form and box menus stay inside the visible window and open above the field when needed; use arrow keys and Enter to select or Escape to close. QuickBooks Online alone offers Include credit-card and third-party payments, initially unchecked. The final review shows that choice. For tax year 2026, selecting an enabled 1099-NEC mapping sets the default combined-vendor threshold to $2,000 across all six integrations. Other years and MISC-only selections keep the $600 starting value. Once you enter a custom amount, changes to year or mappings keep that amount. The filter still applies to combined NEC and MISC totals, so review it when mixing forms.
Step 4 - Destination
Choose Create new filer for a domestic U.S. business with an EIN and review every validated identity, address, email, required Contact name, and required Filer phone number field. Contact details use your profile defaults just like New filer and remain editable. If your profile has no contact name, enter it here before continuing to Review. Create new filer stays available when BILL omits or does not identify the company tax-ID or account type. Review the prefilled details and enter anything missing. A clearly formatted EIN can be prefilled even without a provider tax-ID type; an ambiguous or personal tax ID leaves the EIN field empty for you to complete. Normal legal-name, EIN, address, contact-name, and phone requirements still apply. For an individual or foreign filer, create it in Filers first, then use Search compatible filers plus Next filer page and Back to first page. A source/filer name mismatch is a warning and never silently rewrites the filer. No clear-existing or delete option is offered.
Step 5 - Review
Review your company, filing year, payment mappings, threshold, filer, contact name, contact phone, notification email, and provider limitations. For QuickBooks Online, confirm whether credit-card and third-party payments are included or excluded. Use Back or a completed step to revise a choice, then Start import, or Prepare vendor list for Xero. The What happens next panel explains collection, preparation, and review of the imported results. Importing does not submit forms to the IRS.
Progress and Diagnostics
Follow collection and preparation progress, or use Refresh progress. Import details shows the reference and full counters. Temporary failures retry with increasing waits up to five failures; terminal failure stops calls and releases the filer. A live run returns to Connect with a notice; a failed run opened from Import history stays visible for review. No new import starts until you choose its settings and launch it. Reconnect and resume same import is available for a paused authorization problem before the saved-data deadline. Xero pauses at Choose vendors to import, with no recipients written and no background progress checks until you confirm. After completion, use View recipients and review the automatically loaded Import results. Previous and Next change the result page; Refresh results reloads this page. Review recipient links compare possible duplicates without merging. Finalizing Metrics precedes the completion prompt; Dashboard totals are updating does not prevent viewing saved recipients. If updates pause while you are away, continue using the app or choose Stay signed in. Read each record’s reasons directly; Record details expands references and Compare values toggles saved field conflicts. Counts describe the current page only. View recipients resolves and selects the destination filer even when it is outside the current filer list; a hard refresh is not required. If a page has no records but Next is enabled, continue to the next page. Import paused briefly means request capacity is temporarily unavailable. Your progress is saved and the same import resumes automatically after the displayed time. No action is needed; you can leave and return later. This can come from E-File Magic pacing requests or from the accounting service. Refresh progress reads saved status and does not restart the import. After the temporary details expire, results remain visible but detailed diagnostics are unavailable. New import starts a separate setup.
Wizard Navigation
Continue validates the current step before advancing. The sticky Back button returns to the immediately preceding step, and completed step buttons can reopen earlier choices. The current and future step buttons are disabled, and all step navigation is locked after Progress begins. All integrations returns to the provider directory.
View Imported Records
All connected accounting providers offer Yes, view records and No, stay here after a running import finishes with imported records. Yes selects the import’s destination filer and opens Recipients. No or Close leaves the Progress screen open. Opening completed history does not show another prompt.
Xero - Choose Vendors to Import
Only vendors with paid activity meeting your mappings and threshold appear. Suggested vendors have a 1099 designation or a usable EIN, SSN, or ITIN. View more vendors shows other payment-qualified vendors whose Tax ID needs attention; you can select them and correct their details before filing. Both lists are paginated, including for large accounts. Checking a vendor selects all its candidate forms. Select this page and Clear this page affect the visible page; First page and Next page navigate the current list. Refresh list reloads saved choices. Selections persist across both lists, pages and reloads. Import selected vendors requires at least one selected form. Start a new import cancels this review. Saved payment data lasts 48 hours; after expiry, start again. Your filer remains available during review and must be free when you confirm. Existing saved imports may retain a single vendor list. Separately reported sales tax, card/PayPal payments, unknown funding, unpaid bills and unsupported adjustments are excluded; review source records for needed adjustments before filing.
Import history
Use the New import and Import history tabs at the top, with the same outlined tabs and icon boxes as Reports. The selected tab is highlighted in blue. On narrow screens the tabs stack. Use Left/Right arrows, Home or End while a tab has keyboard focus to switch views. Browse saved accounting runs separately from spreadsheet uploads. The all-services page offers Integration and Status filters; a provider page shows only that service and offers Status. Each row shows its source, tax year when available, creation date, status and result counts. Refresh history reloads; Previous and Next page through results. Resume vendor review returns to an unexpired Xero selection. View progress and View results open the saved run. Loading, empty, and error messages describe the current page; use Refresh history after an error. After source expiry, saved counts remain and the page explains which temporary details are unavailable. Tabs and Back to import history are disabled while connection, launch, or vendor-review actions are in progress.
Review individual import results
Import results loads automatically when an import completes or fails. Each row shows its record number, form when available, outcome and saved reasons. Completed with skipped records calls attention to exclusions; if nothing was imported, the summary says so. Imported · review needed means the recipient was saved with issues that need review before filing. Source activity is separate from recipient forms; an excluded source record is not necessarily a rejected vendor. Older generic reasons cannot identify a more specific cause. Compare your imported recipients and totals with your accounting records before repeating an import. Previous and Next move between pages of up to 25 records; the count describes this page only. Previous is disabled on the first page; Next is disabled when there are no further results. A page can be empty and still offer Next. Refresh results reloads the current page. Loading disables paging and refresh. If a read fails, existing results stay visible and Try again retries that request. Record details expands the saved reference, vendor reference when available and reason codes for support. Compare values shows or hides the saved local and provider values for conflicts. Review recipient candidate links open possible matches in this filer without merging or changing records. Exact excluded expense amounts remain visible. Import details expands the submission reference and full totals; Refresh progress updates the saved status. View recipients opens the destination filer. Detailed results expire after the temporary retention period, while saved totals and imported recipients remain available.
Actions and controls
- Use New import and Import history on the integrations page and on every provider page. The first tab starts or prepares work; the second lists saved runs and their results.
- Open Accounting integrations to load the available accounting services automatically.
- Choose Import on the IRS 1220 tile to open the file-import page. The upload area receives a brief green highlight and keyboard focus. Choose or drop your Publication 1220 file there, then review it before starting the import. This tile is available even while accounting connections are loading or unavailable.
- Use the single action on a provider tile: Account Admins see Connect or Manage; other account users see Review or Import. The action opens that provider’s setup and import page.
- From any provider page, use All integrations to return to the integrations directory without starting or changing an import.
- Follow Connect, Company, Map payments, Filer, Review, and Import. Xero adds a separate Choose vendors step before Import. Your import summarizes the selected company, year, filer, and mapping. Use Back, a completed step, or Change in the summary to revisit earlier choices. Future steps stay unavailable and navigation stops after the import starts.
- Read each tile’s connection status and available company count. Needs reauthorization and Connection error identify connections that need attention. Not configured and Not enabled actions stay disabled. Sample data appears once above the tiles when every provider uses samples; when services have different modes, only sample providers have that label on their own tile.
- All active account users can select an existing provider connection, refresh company discovery, and run imports. Account administrators can additionally connect another provider, reconnect the same saved grant, cancel a BILL reconnect before submitting, or disconnect after confirming the warning. In the disconnect dialog, use Close or Cancel to leave the connection unchanged, or Disconnect to queue revocation.
- For Zoho Books, select the United States, Europe, India, Australia, Japan, Canada, China, Saudi Arabia, or United Kingdom data center where the organization is hosted before connecting or reconnecting.
- For BILL, connect using your sign-in email address, organization ID, and AP/AR sync token. The first connection shows the form. After connecting, the form closes and your saved connection is selected. Click Continue to company. To connect an additional company, click Connect another organization; Cancel returns to your connections and clears the inputs. Reconnect opens fresh fields for that saved connection; Cancel reconnect returns to the connections list. The token field clears after every attempt.
- Choose exactly one accessible external company with valid USD authority. Most providers show their verified home currency; BILL shows USD verified per record because BILL does not provide an organization home-currency field.
- When you create a new filer, review every prefilled provider detail before continuing, including the required Contact name and Filer phone number. Contact name, Notification email, and Filer phone number start with the same profile details used by New filer. You can edit them for this filer; your edits, including cleared values, stay in place if your profile finishes loading later. Company identity and address still come from the provider. Provider email and phone are fallbacks when your profile does not supply them. Enter 10 or 11 digits; common phone punctuation is accepted. Missing or invalid values keep you on Filer and focus the field. QuickBooks Online can supply the company or legal name, tax ID, contact email, phone, address, and country from its company profile. Xero prefers its mailing address and its default, direct-dial, or mobile contact phone instead of relying on provider list order. Zoho Books can supply the legal name, tax ID, contact email, and address from the selected active organization. FreshBooks can supply the business name, public contact email, phone, and address from the selected active Accounting System, with its Identity Business profile filling only missing values. BILL prefers its mailing address. Correct incomplete values in the review form.
- Choose a supported filing year and keep or change the combined-vendor threshold. Search accounts or categories and map them to compatible 1099-NEC or 1099-MISC amount boxes for that year.
- For Xero, map accounts, choose a filer, and click Prepare vendor list. E-File Magic reads paid bills and direct spending, calculates mapped totals, and lists vendors meeting your threshold. Choose which vendors to import; a contact group is a helpful label, not a decision about whether a vendor needs a 1099.
- For BILL, only cleared online payments and recorded paid-offline payments with a provider payment date are treated as cash paid; scheduled, in-flight, missing-date, and unknown payment states are left for review.
- For FreshBooks, bill tax stays outside mapped pre-tax 1099 categories. Direct expenses that have only a typed vendor name are excluded for review, and their diagnostic shows the exact excluded amount without exposing the vendor label.
- For Business Central, use a company where your administrator installed the read-only E-File Magic Payables extension and assigned EFM Payables Read to the dedicated integration user. E-File Magic combines the company's verified records with exact applied payments and posted G/L distributions; the payment posting date determines the filing year. It does not treat payment journals or the public Analytics feed as paid history. Unsupported adjustments or foreign-currency documents stop the import safely for review.
- Clear mappings or restore suggested mappings before continuing.
- Create a new domestic U.S. business filer with an EIN, or search and page through compatible, unlocked existing filers for the same year. Create new filer stays available when BILL omits or does not identify the company tax-ID or account type. Review the prefilled details and enter anything missing. A clearly formatted EIN can be prefilled even without a provider tax-ID type; an ambiguous or personal tax ID leaves the EIN field empty for you to complete. Normal legal-name, EIN, address, contact-name, and phone requirements still apply. Create an individual or foreign filer in the full Filers workspace first, then select it here.
- Review the provider, source, year, currency, import mode, mappings, threshold, proportional-payment rule, destination, notification email, and provider limitation.
- Use Start import after reviewing your selections, or Prepare vendor list for Xero. Duplicate clicks are disabled. For Xero, no recipients are created until you choose vendors and click Import selected vendors.
- Leave and return while an import runs, or use Refresh progress. Temporary provider failures receive up to five failed attempts with increasing waits. A terminal failure stops automatic calls, releases this import’s filer lock, and returns you to Connect with a failure notice. Choose a different company, year, threshold, mappings, or filer and explicitly start a new import. If authorization expires while a run is paused, reconnect the saved connection before the displayed deadline.
- Continue importing valid provider records when another source record is incomplete or cannot be resolved safely. E-File Magic does not guess a QuickBooks Item account, join a free-text FreshBooks vendor, or replace a missing Zoho detail; the affected source record appears in terminal diagnostics without implying that a recipient failed validation.
- Import results loads automatically when an import completes or fails. Each row shows its record number, form when available, outcome and saved reasons. Completed with skipped records calls attention to exclusions; if nothing was imported, the summary says so. Imported · review needed means the recipient was saved with issues that need review before filing. Source activity is separate from recipient forms; an excluded source record is not necessarily a rejected vendor. Older generic reasons cannot identify a more specific cause. Compare your imported recipients and totals with your accounting records before repeating an import. Previous and Next move between pages of up to 25 records; the count describes this page only. Previous is disabled on the first page; Next is disabled when there are no further results. A page can be empty and still offer Next. Refresh results reloads the current page. Loading disables paging and refresh. If a read fails, existing results stay visible and Try again retries that request. Record details expands the saved reference, vendor reference when available and reason codes for support. Compare values shows or hides the saved local and provider values for conflicts. Review recipient candidate links open possible matches in this filer without merging or changing records. Exact excluded expense amounts remain visible. Import details expands the submission reference and full totals; Refresh progress updates the saved status. View recipients opens the destination filer. Detailed results expire after the temporary retention period, while saved totals and imported recipients remain available.
- Use Start another import after completion. Failures return to Connect automatically, preserving the failure notice and history. At Xero vendor selection, Start a new import cancels the pending selection and returns to Connect. Existing recipients are never cleared.
- When an import finishes with imported records, View imported records? appears. Choose Yes, view records to open Recipients for the destination filer, or No, stay here to keep reviewing the import. Closing the dialog also keeps you here. The prompt waits until processing and Finalizing Metrics finish and does not appear for failed imports or imports with no records.
- Xero disconnects the imported company automatically after a successful import. Your imported forms and history stay in E-File Magic. Reconnect for another import, including next year. Other active Xero imports finish before disconnection runs.
- From import history, use Review vendors to reopen a saved Xero selection. A failed accounting import offers Start a new import so you can choose a different scenario without retrying the failed run.
- If no vendors match your selections, the import finishes without creating recipients. Use Start another import to change the year, threshold or mappings; review any available exclusion diagnostics.
- New filer details validate as you type using the same filing-year requirements as the Filers screen. Invalid EINs, legal names and addresses appear beside their fields. Correct them before continuing. If filer requirements cannot load, use Reload filer requirements.
- For Xero, Prepare vendor list reads mapped payments and calculates vendor totals. Preparation can continue after all payment pages arrive. Choose vendors stays active until you select vendors and confirm Import selected vendors; only then does Import become active. A vendor-list loading error does not import anything: use Refresh list, and contact support if it persists.
- New import history stays available until its filer is deleted. A Multi-Filer import stays available until its last associated filer is deleted. Unattached upload drafts and temporary source details expire after 48 hours. Imported recipients and the saved result counts do not expire with those temporary details. Older history that has already expired cannot be recovered here.
- In Connect, use an existing connected company for another import. Expand Disconnected connections to review old authorizations or reconnect. Starting another import does not create another connection by itself.
If you get stuck
A provider tile is disabled or says Not configured.
The server controls availability. Ask your administrator or E-File Magic support to confirm provider activation; the browser cannot bypass it.
The company is blocked because its currency authority is not valid for USD import.
For providers that report home currency, select a USD company or correct the provider reporting currency. If currency could not be verified, refresh discovery or reconnect. BILL must show USD verified per record; individual BILL records without USD proof are skipped for review.
The import asks for reauthorization or says its evidence deadline passed.
Click Reconnect and resume same import and restore the exact saved connection. The existing submission resumes only after its recorded company is active. If the displayed evidence deadline has passed, start a new import; do not expect the expired submission to resume.
A saved import says its temporary details expired.
Review its saved status and counts and open the imported recipients. Start a new import to collect fresh source data. Expired source details and diagnostics cannot be resumed or restored by refreshing.
More troubleshooting (22)
Provider authorization was cancelled, expired, or did not return to E-File Magic.
For QuickBooks Online, Xero, Zoho Books, FreshBooks, and Business Central, allow popups for E-File Magic, keep the integration page open, and click Connect or Reconnect again. Finish sign-in in the provider popup. Restart a blocked, manually closed, cancelled, or expired attempt.
Zoho Books opens the wrong region or cannot find the organization.
Return to Connections, select the data center shown in the Zoho Books URL or account settings, and start a new authorization. Use the same data center when reconnecting.
BILL rejects the connection request and the sync-token field is empty.
Check that BILL email address is your sign-in email and that the organization ID and generated AP/AR sync token belong to the same BILL company. Expand Where to find your BILL connection details for the exact settings. Paste the token again after a failed attempt; the field clears automatically.
A Business Central company is unavailable or the import says the E-File Magic Payables extension is required.
Ask your Business Central administrator to install the current E-File Magic Payables extension and assign EFM Payables Read to the dedicated integration user. Then reconnect or click Refresh companies. Do not substitute a payment-journal or Analytics export. If the extension is already installed, confirm its version and the environment's sandbox approval with E-File Magic support.
A connection stays in Discovering companies.
Wait for automatic polling, then click Refresh list or Refresh companies. Reconnect if the provider reports an authorization error.
Refresh companies or Disconnect says the connection changed.
Another administrator or background discovery updated this connection first. Click Refresh list, review the latest connection status, and then choose Refresh companies or Disconnect again if it is still needed.
No companies appear or the expected company is inaccessible.
Click Refresh companies and confirm the connected provider user can read that company. Reconnect if access recently changed.
Continue is blocked on the mapping step.
Enable at least one account and choose a form and an amount box for every enabled row. Replace old choices with boxes currently offered for the selected filing year.
Xero shows no candidate vendors or an unexpected amount.
Check the selected payment year, account mappings, threshold, and source payment records. Prior-year bills count when paid in the selected year. Unpaid bills, card/PayPal payments, unknown funding, foreign currency and unsupported adjustments are excluded. Use Start a new import to change your choices; review source records for adjustments before filing.
Launch says a selected 1099 box is no longer compatible.
Return to Year and Mapping and choose an amount box offered for the selected year. If the filer’s year or forms changed while Xero was waiting for vendor selection, start a new import.
No existing filer is listed.
Existing destinations must be active, unlocked 1099 filers for the selected year. For a U.S. business, choose Create new filer and fill in missing company details here, including your EIN. Provider tax-ID or account types do not block that review. Create individual or foreign filers in the full Filers workspace, then select them here.
The import is rate-limited, delayed, or appears stalled.
Import paused briefly means request capacity is temporarily unavailable. Your progress is saved and the same import resumes automatically after the displayed time. No action is needed; you can leave and return later. This can come from E-File Magic pacing requests or from the accounting service. Refresh progress reads saved status and does not restart the import. Temporary provider-read failures retry with increasing waits up to five failed attempts; local capacity waits do not count as failed reads. A terminal failure stops automatic requests and returns to Connect. Choose and launch a new import explicitly only after a terminal failure, or contact support with its reference.
A completed import shows conflicts, likely duplicates, validation skips, or not-seen rows.
Review the automatically loaded Import results and read each record’s saved reasons. Use Previous and Next to review more records. When Review recipient links are shown for a likely duplicate, click each one to compare the possible match under the same filer; a link does not merge records or change recipient data. If no link is shown, the earlier candidate no longer exists under that filer. Local changes were preserved, incomplete or invalid provider records were skipped without blocking unrelated valid rows, and not-seen provider rows were left unchanged. A QuickBooks Item with no safe expense account or a Zoho record whose detail disappeared is intentionally left for review rather than guessed. For a FreshBooks direct expense with no stable vendor identity, review the exact excluded count and amount shown on the diagnostic.
The completion dialog could not open my recipients.
Try Yes, view records again. You can also choose No, stay here, then open Recipients from the menu and select the destination filer. The import remains saved.
An existing connection is marked Mock when I want actual accounting data.
Use a new connection authorized through the provider sign-in screen after real provider access is configured. A Mock connection contains demonstration data.
The import completed, but Xero still needs to disconnect.
Your imported recipients are saved; do not repeat the import. E-File Magic retries automatically. If the completion screen says disconnection could not be confirmed, remove E-File Magic from the organisation’s connected apps in Xero, or contact support.
Create new filer asks for a contact name or shows the wrong contact details.
On Filer, review Contact name, Notification email, and Filer phone number. They start with your profile details, just like New filer. Enter a contact name if your profile has none, and correct the email or phone for this filer. Contact name and Filer phone number must be filled before Continue to review; clearing either keeps you on Filer and focuses the missing field.
Xero vendor choices changed, expired, or cannot be confirmed.
Refresh list to load the saved choices after a conflict. If another import is using the filer, wait for it to finish before confirming. If saved payment data expired, use Start a new import. No recipients are written before confirmation.
The import succeeded but diagnostics show many skipped source records.
Expand Source records excluded from calculation. These are accounting activity records, not additional vendors that failed. A generic saved reason cannot say which records were non-reportable versus incomplete. Compare the imported forms with your expected vendors and amounts; do not repeat the import solely to remove these diagnostics.
Connection counts differ from the number of cards in Connect.
Tile counts include connected authorizations only. Expand Disconnected connections to see old authorizations. Imports reuse a selected connection; another import alone does not create an authorization. Xero disconnects the imported company after completion once other active imports no longer need it.
Xero is waiting for another import before disconnecting.
Resume or finish any other unexpired vendor review if needed. An expired vendor review no longer holds the connection open. Processing imports still have to finish safely. Confirm disconnection from the displayed connection status; import completion by itself is not proof.
The import completed but no recipients were imported.
Read the saved reasons in Import results and use Previous and Next to inspect further pages. Source exclusions may describe accounting activity rather than rejected vendors. Compare your expected recipients, year and mappings before starting another import.