{"title":"The QuickBooks Data Migration Extension","url":"https://jonas-paprotka.de/docs/ui-extensions-quickbooks-data-migration/","by":"JOP-AL","license":"Copyright (c) Microsoft Corporation. CC BY 4.0, https://creativecommons.org/licenses/by/4.0/; code samples MIT. From https://learn.microsoft.com/en-us/dynamics365/business-central/ui-extensions-quickbooks-data-migration, MicrosoftDocs/dynamics365smb-docs at 46907ac (2026-11-19). Changed: includes filled in, links to this site, and for agents shortened without dropping a fact.","credit":"Microsoft Corporation, CC BY 4.0","origin":"https://learn.microsoft.com/en-us/dynamics365/business-central/ui-extensions-quickbooks-data-migration","source":{"name":"Business Central application docs","repo":"https://github.com/MicrosoftDocs/dynamics365smb-docs","commit":"46907ace177f8d31deba47a2fdb57c3336e66252","date":"2026-11-19"},"checked":"2026-11-19","description":"Describes how to use the extension to import customers, vendors, items, and accounts from QuickBooks Desktop to Business Central.","date":"2021-06-24","meta":{"topic":"article"},"outline":[{"level":2,"title":"Data from QuickBooks desktop","slug":"data-from-quickbooks-desktop","at":374,"chars":830},{"level":2,"title":"Before you start","slug":"before-you-start","at":1204,"chars":1092},{"level":2,"title":"Finding the QuickBooks data migration extension","slug":"finding-the-quickbooks-data-migration-extension","at":2296,"chars":443},{"level":2,"title":"What do I do after I migrate data?","slug":"what-do-i-do-after-i-migrate-data","at":2739,"chars":939},{"level":2,"title":"Related information","slug":"related-information","at":3678,"chars":299}],"text":"This extension makes it easy to migrate customers, vendors, items, and accounts from QuickBooks to Business Central. If your business uses QuickBooks today, you can export the relevant information and then open an assisted setup guide to upload the data to Business Central.\nSee Importing Business Data from Other Finance Systems<across-import-data-configuration-packages>.\n## Data from QuickBooks desktop\nYou can import the following data from QuickBooks Online to Business Central:\n Customers\n Vendors\n Items\n Chart of Accounts\n Beginning Balance transactions in General Ledger\n On-hand Quantities for Inventory Items\n Open documents for customers and vendors, such as invoices, credit memos and payments\nWe migrate only full amounts on sales and purchase documents. We do not update partially paid amounts. For example, if a customer has paid 300 of a total of 500 dollars on a sales invoice, we migrate the full 500. If you have received partial payments, you must update these manually, either before or after you migrate data. We recommend that you apply outstanding transactions before you migrate, just to make things easier afterward.\n> NOTE\n> We do not migrate purchase orders or sales orders.\n## Before you start\nAn important part of the migration process is to specify the accounts to migrate transactions to. It's a good idea to plan this mapping before you migrate data. For example, the accounts where you post transactions for:\n The sale of items or services to customers\n The purchase of items or services from vendors\n Adjustments in the general ledger\nBusiness Central requires that general ledger accounts have account numbers assigned to them. Make sure that account numbers are assigned to your accounts in QuickBooks.\nIf transactions in QuickBooks have tax amounts, you must set up a tax account for your tax jurisdictions in Business Central before you can post transactions.\nIn order to get your data out of the QuickBooks desktop application you will need to download the Microsoft Data Exporter Tool. The instructions for the tool are in the Data Migration Wizard in Business Central. The tool will connect to your QuickBooks application and export the applicable data to a .zip file.\n> NOTE\n> Currently the data exporter tool only works with QuickBooks 2017 and 2018.\n## Finding the QuickBooks data migration extension\nThe QuickBooks Data Migration extension is installed and ready to go as an integrated part of the Data Migration assisted setup guide. If you are ready to get started now, and have exported your data from QuickBooks, select Search (Alt+Q) in the upper-right corner, enter Assisted Setup, and then choose the related link. Choose Migrate business data, and then follow the steps in the guide.\n## What do I do after I migrate data?\nAfter you migrate data, transactions have the status Unposted, so you can review them and make adjustments. To review the transactions, go to the page where you would normally find them. For example, to review unposted sales invoices, go to the Sales Invoices page. To review payment journals, go to the Payment Journals page.\nThere are a few things in particular that you should do:\nIf the transactions in QuickBooks had markup or discount amounts, you must manually add the amounts to the related transactions in Business Central before you post them.\nIf you are using value added tax (VAT), you may need to add a business posting group and a product posting group to the posting setup so that you can post VAT amounts.\nVerify the beginning balances for accounts in the general ledger. QuickBooks does not store the current balance for all accounts, so you might need to correct beginning balances.\n## Related information\nImporting Business Data from Other Finance Systems<across-import-data-configuration-packages>\nCustomizing Business Central Using Extensions<ui-extensions>\nFind free e-learning modules for Business Central here<https://learn.microsoft.com/training/dynamics365/business-central>"}