Skip to content

Migration guide

Move from FreshBooks with a preservation-first cutover

Move from FreshBooks to Invoice Crowd with preserved exports, deliberate customer and invoice mapping, a test import, and reconciled totals.

  • Preservation before transformation
  • CSV and Excel mapping
  • Reconcile before activation
Invoice Crowd Import File window for estimates, with client, estimate number, date, valid-until date, totals and line items mapped to columns from the exported file

Safe cutover

A four-part migration control, not a file upload

Invoice Crowd may fit teams that want purchases, vendors, accounting reports and multi-business context beside client billing. FreshBooks can remain the better fit where its polished client-service workflow, support or established integrations are central.

Preserve before transforming

The source remains the evidence for history the target does not recreate.

Invoice Crowd Smart Import step for invoices with an exported invoices file chosen, while expense, payment, time and report exports stay archived

Build a read-only migration archive

Export clients, items or services, invoices and estimates plus any available expense, payment, time and report archives. Preserve PDFs and the original account for material history that is not represented by the target import types.

  • Dated original exports
  • PDFs and attachments
  • Source access retained

Define the historical boundary

Decide which records must operate in Invoice Crowd and which remain in the source archive. Record the cutover date, owners and retention requirements.

  • Operational records
  • Historical evidence
  • Retention owner

Normalize and test

Invoice Crowd analyzes CSV, TXT, XLS and XLSX files before supported imports.

Invoice Crowd Map CSV Columns step for customers with company, contact name, email, tax number, address, phone and currency matched to file columns

Map the supported record types

Current analyzers cover items, customers, vendors, invoices and estimates. Auto-detection suggests columns, but required fields and warnings must be reviewed before import.

  • Customers and vendors
  • Items
  • Invoices and estimates

Use a representative test set

Test duplicate names, foreign currencies, taxes, discounts, long descriptions and open documents. Review the preview and skipped-row output instead of assuming a successful request means every row was accepted.

  • Representative edge cases
  • Preview and warnings
  • Skipped-row report

Reconcile and cut over

Activation follows totals, document meaning and ownership, not a raw row count.

Invoice Crowd Trial Balance after the move with equal total debits and credits, and recurring invoices, retainers and late fees set up again in Invoice Crowd

Prove the target working set

FreshBooks projects, time, expenses, retainers, payments, credits, late fees, recurring profiles, attachments and custom fields need an explicit keep, rebuild or archive decision. Do not treat a row count as proof that balances or document meaning survived. Invoice Crowd has its own recurring invoices, retainers and late fees, so set up the ones you still need instead of importing them; recurring invoices and retainers need a paid plan.

  • Counts and totals
  • Open document balances
  • Currencies and tax context

Run a controlled switch

Pause or sequence writes, take final exports, import approved deltas, reconcile opening and open-document totals, and keep a documented fallback path before inviting the wider team.

  • Final dated export
  • Approved opening position
  • Rollback and archive links

Migration checklist

The evidence to collect before you switch

Use this checklist with the people responsible for bookkeeping, operations, retention and customer communication.

  • Source archive

    Keep dated, immutable source exports and access.

  • Supported files

    Use CSV, TXT, XLS or XLSX within the configured upload limit.

  • Customers

    Map required identity and contact fields.

  • Vendors

    Map supplier identity and contact fields.

  • Items

    Map product and service fields deliberately.

  • Invoices

    Preserve document number, dates, customer, currency, lines, tax, discounts and totals.

  • Estimates

    Preserve quote identity, dates, customer and line details.

  • Preview

    Review detected headers, suggested mapping, required fields and sample rows.

  • Warnings

    Resolve missing required fields before committing the job.

  • Skipped rows

    Download and review rejected records instead of hiding them.

  • Reconciliation

    Match open documents, customer balances and approved opening totals.

  • Historical boundary

    Record what remains in FreshBooks and why.

Questions

FreshBooks migration, answered

Is this a one-click migration from FreshBooks?

No. Invoice Crowd currently analyzes and imports supported CSV or Excel data for items, customers, vendors, invoices and estimates. Historical records and provider-specific structures need an explicit archive, rebuild or reconciliation decision.

Which file types can I upload?

Invoice Crowd imports CSV, TXT, XLS and XLSX files within the upload size limit. Item imports are checked in batches of up to 1,000 rows or 2 MiB.

Which records have dedicated analyzers?

Items, customers, vendors, invoices and estimates. Item imports show a full preview first, and one invalid row stops the whole batch until you fix it. Bank reconciliation has a separate import workflow and is not a substitute for migrating a complete accounting ledger.

Should I close the old account after importing?

Not immediately. Keep source access and immutable exports until financial, tax, contractual and audit retention needs are covered and every material balance has been reconciled.

How do I know the migration worked?

Check field mapping, warnings, row outcomes, representative document rendering, open balances, currencies, taxes and approved opening totals. A successful upload or matching row count is not enough.

What happens to data that has no target field?

Document it in the migration register and either preserve it in the source archive, attach it through a supported operational process, or rebuild it deliberately. Never silently discard it.

Test with copies before moving live work

Create the archive, normalize a representative set, inspect warnings and skipped rows, and reconcile the result before the production cutover.

  • Source history preserved
  • Visible mapping review
  • Reconciled activation gate