Migrating to an ERP with a Direct Ramp Integration

Ramp’s ERP Migration Tool helps you transition from one accounting provider to another — like QuickBooks to NetSuite — in under an hour. This guide walks you through the process.

What to expect

Switching ERPs is often complex. But Ramp automates the hardest part — preserving your:

Historical codings from your prior ERP connection will not be preserved

Estimated time using ERP migration tool: 15–60 minutes

Steps before you use Ramp’s migration tool

Step 1: Choose a transition date

Step 2: If you can, pay off any bills in Ramp prior to the transition date and wait on creating any further bills until after the transition

Note: In flight bills will not automatically be transferred to the new accounting provider. Therefore, you will have two options for inflight bills:

  1. Manually add the payments to their old ERP and remove the bills from Ramp by marking them as synced.
  2. Resync the inflight flight bills to their new ERP by clicking retry bill and bill payment sync.

Step 3: Finalize and close out procurement activity prior to the transition date

If utilizing Procurement in Ramp, it's important to review and resolve any outstanding procurement activity. Since Ramp's procurement workflows are tightly integrated with bill creation, any in-flight requests or open purchase orders can result in incomplete or incorrectly coded transactions if processed after the transition date.

Review all open purchase requests and purchase orders. Complete and close out as many as possible before your transition date. This ensures that related bills can be approved, paid, and synced to your old accounting system as part of your close.

Avoid initiating new purchase requests in Ramp during the final days leading up to the transition. If necessary, pause procurement workflows or manage approvals outside of Ramp until your new ERP connection is live and fully configured.

Clean up vendor data in Ramp. Consolidate duplicate vendor records and ensure vendor names and metadata are standardized. The migration tool will use these records when mapping historical data to your new ERP structure, and inconsistencies can lead to failed or misrouted bill syncs.

Step 4: Sync all of your card transactions to your old accounting system up until the transition date, and leave any transactions dated after the transition date as unsynced

Within your old accounting system, you want to perform a close to get the final account values as of the transition date. Therefore, you should sync all expenses incurred up to the transition date over to your accounting system. You may need to wait a few days after the transition date for any uncleared card transactions that occurred in the previous period to clear. Once they’re cleared, sync everything up to that date and then hold off syncing anything else until the transition is done.

Step 5: Sync all of your approved reimbursements to your old accounting system up until the transition date, and leave any reimbursements dated after the transition date as unsynced

As with cards, you want to sync across any reimbursements and repayments dated in the period prior to the transition date into the old accounting system before closing your books.

Step 6: Perform a final close on your old accounting system, generate trial balances, and import them into your new system

Note: If you don’t have a lot of transaction history, it may be beneficial to transfer all of your historical transactions to the new system rather than importing trial balances. When you import trial balances, you lose the ability to generate financial statements that occur within or span a period prior to the transition date. The mechanics of importing all historical journals are too complex to fully cover here - it is worth contacting your new accounting provider to discuss which approach is right for you.

Step-by-Step migration guide

Step 1: Go to accounting settings

Navigate to Accounting Settings in your Ramp dashboard. Click switch accounting providers.

Accounting Settings page with Switch accounting providers button in the Danger Zone

Step 2: Start the migration process

Click Switch accounting providers in the “Danger Zone” section. You’ll see a preview of the process:

Click Disconnect & begin switching to proceed.

Switch accounting providers overview with timeline and Disconnect and begin switching button

Step 3: Connect your new provider

Before you proceed: Note that many accounting providers have very stringent pre-configuration steps that must be completed before you can successfully integrate with them. Please make sure you've reviewed the Ramp setup guide that pertains to your new provider. Steps pertaining to roles, versions, and permissions are of utmost importance and the migration will stall if these are not completed!

Find your setup guide here and keep it open in another tab. Then, select and authenticate your new accounting provider.

Once authenticated, Ramp will take a few moments to prepare the necessary information for you to review and complete the migration.

Note: For large businesses, this process can take a significant amount of time, so Ramp allows you to leave and come back once we've finalized gathering the data.

Accounting page showing migration preparation in progress from CSV to QuickBooks

Once prepared Ramp will ask you to get started and review the information.

Accounting page with Get started button ready to begin the migration

Step 4: Map your accounting fields

Ramp automatically maps your existing accounting data to your new ERP. You’ll see a preview of field matches — like Category, Class, Customer/Job, and Vendor.

Click Continue once fields are mapped.

Field mapping screen showing CSV fields mapped to QuickBooks equivalents

Step 5: Review matched values

Ramp highlights options that are:

After verifying each group, click Mark as ready.

Review matched options page with Category, Class, Customer/Job, and Vendor fields

Review Class field showing matched, skipped, and unmatched options with Mark as ready button

Step 6: Finalize the migration

Once all fields are marked “Ready,” click Finish and migrate to complete the switch.

Next step in migration review displaying matched and skipped options with

Ramp will begin migrating your historical data and settings. This will take a few minutes.

Accounting section showing CSV file migration to QuickBooks with a notification on historical data transfer.

Post-Migration: keep working without disruption

Your accounting sync and workflows resume with your new provider — no need to reset rules, categories, or vendor links, etc.

Ramp Card section showing accounting transactions, with options to sync, view details, and manage categories.

ERP migration CSV export

What it does: Creates a backup of your historical accounting data before switching ERPs. This ensures you have a record of all coded transactions in case anything goes wrong during migration.

What's exported (3 separate CSVs, delivered in one email):

Key limitations:

How to use: Start the export from the ERP Migration page before disconnecting your old provider. You'll receive one email with download links for all 3 CSVs when complete.

Permission required: Accounting Setup access.

Frequently asked questions

What ERP migrations are supported?

Note: Customer who is transitioning from direct accounting integration to ucsv is not supported.

What should I know before kicking off the migration?

The flow will enable you to map all of your accounting fields and field options from your prior accounting provider to your new accounting provider. Ramp will then migrate all of your spend policies, rules, and any transaction codings where the transaction has not been synced to the old accounting provider. Transactions that were synced to the old provider will not be updated and no record will maintain in Ramp. Transactions that have not been synced to the old provider will be updated with the coding from the new accounting provider.

How does the ERP migration tool support in-flight bills?

In flight bills will not automatically be transferred to the new accounting provider. Therefore, you will have two options for inflight bills:

  1. Manually add the payments to their old ERP and remove the bills from Ramp by marking them as synced.
  2. Resync the inflight flight bills to their new ERP by clicking retry bill and bill payment sync.

Can I bulk-reset the sync status of previously synced transactions after migrating?

No. There is no way to bulk-reset or bulk-unsync transactions that were already synced to your old accounting provider. Those transactions remain marked as synced and do not re-appear in the Accounting queue for your new provider.

Instead, to get historical transaction data into your new system after migrating, use the ERP Migration CSV Export described above. It generates CSV files covering your synced transactions, reimbursements, and bills, which you can then import into your new accounting provider.

Transactions that were not synced to your old provider before the migration are automatically remapped to your new provider's accounting field mappings and appear in the Accounting queue ready to sync.

What happens if I need to reverse the migration?

If a customer experiences issues, then they can revert back to their old accounting provider connection and transaction codings and accounting rules will be restored. However, all workflows, bill codings, vendor codings, codings created by card rules will not be restored.