Logistics and distribution
Prophet 21 cloud migration: what to do with your historical order data
By SourceX Editorial · Updated
Short answer
In a Prophet 21 cloud migration, historical order data can follow three paths: move with the database, go to a read-only archive, or be exported to files your company controls. Whichever path you choose, capture order lines, notes, attachments, custom fields and audit history before cutover, because the legacy server is usually retired soon after go-live.
Key takeaways
- Moving the same P21 database to a hosted environment usually carries history with it, but how you can query that history may change.
- Moving to a different ERP usually converts masters and open transactions, leaving most closed history behind.
- Notes, document attachments, user-defined fields and custom reports are the items most often missed.
- A documented, read-only archive in company storage keeps history usable for audits, disputes, analytics and possible licensing.
What happens to order history in a Prophet 21 cloud move?#
What happens to order history in a Prophet 21 cloud move depends on which move you are making. Moving your existing P21 database to an Epicor-hosted or SaaS environment generally keeps history with the database, while leaving P21 for a different cloud ERP usually brings across masters and open transactions and little else.
Even in a like-for-like move, access changes. On premises, your team or partner may have queried the database directly, run custom reports and linked documents on local file shares. In a hosted environment, direct database access, custom objects and file paths may work differently, so confirm with Epicor or your partner what will be available after go-live.
Treat the migration as the moment to decide what history you keep, where it lives and who can reach it once the legacy server is shut down. That decision is much harder to make after the hardware has been wiped.
Migrate, archive or export: comparing the options#
Migrating, archiving and exporting are not exclusive, and most IT teams combine them. The table compares the options for closed orders and the history around them.
Whichever mix you choose, verify it. Pick a sample of old orders and confirm that each one can be found, with its lines, notes, attachments and invoice, in the place you expect after cutover. A verification log signed by the IT director and the controller is a simple, durable record.
| Option | What it keeps | What you can lose | Best when |
|---|---|---|---|
| Migrate full history | Orders, invoices and transactions inside the new environment | Custom tables, file-share attachments, direct query access | Moving the same P21 database to a hosted environment |
| Migrate recent, archive the rest | Recent history live; older history in a read-only database | The convenience of one system for old lookups | Database size or conversion scope is a concern |
| Export to files | Tables as CSV or columnar files plus documents, in company storage | Screens and business logic; needs documentation to read | Leaving P21 for another ERP |
| Keep the legacy server read-only | Everything, exactly as it was | Ongoing licensing, patching and security exposure | A short bridge while exports are verified |
What to keep before cutover#
Before cutover, keep every table that describes a business event, not just the ones the new system needs to run. Compare this list with your partner's conversion scope to find the gaps.
Include canceled and lost business. Canceled lines, expired quotes and returns are often filtered out of conversions as clutter, yet they show demand that went unmet and problems that were fixed, which makes them some of the most informative records a distributor holds.
- Order headers and lines, including canceled lines and backorders.
- Quotes and their conversion to orders.
- Invoices, credit memos and return authorizations with reason codes.
- Purchase orders, receipts and vendor returns.
- Inventory transactions, adjustments and cycle count results.
- Customer and ship-to masters with historical contacts and terms.
- Item master with supersessions, customer part number cross-references and discontinued items.
- Price pages, contracts and their effective dates.
- Notes and activities attached to orders, customers and items.
- Document attachments such as scanned purchase orders, packing lists and proofs of delivery.
- User-defined fields, custom tables and audit columns showing who changed what.
Where history slips through: notes, attachments and customizations#
History slips through in the places a conversion template does not reach: free-text notes, document links and customizations. Each needs a deliberate decision.
Notes often live in separate tables keyed to orders, customers or items, and conversions frequently skip them. Attachments are often stored as file paths that point to a server share, so the database row survives while the document becomes unreachable. Export the files with a manifest that maps each document to its order or customer ID.
Customizations are the third risk. User-defined fields, business rules and reports built up over many years encode how the business actually ran. Document what each custom field meant and when it was introduced, or the exported values will mean nothing to anyone who reads them later.
Reports deserve the same treatment. Export the definitions of key custom reports, not only their output, so the logic behind familiar numbers survives the move.
Questions to settle with Epicor or your partner#
Settling a short list of questions in writing before cutover avoids most surprises. The answers belong in the migration plan, not in someone's memory, and they should name who is responsible for each export.
| Question | Why it matters |
|---|---|
| Which tables and years of history are in the conversion scope? | Anything outside the scope is yours to export |
| How are notes and attachments handled? | These are the items most often left behind |
| What database or reporting access will we have after go-live? | Decides whether history stays queryable |
| What happens to custom tables and user-defined fields? | Custom data may not carry over intact |
| How long will the legacy environment remain available? | Sets the deadline for verifying exports |
| What do our agreements say about data return and export? | Governs access if you change providers later |
Illustrative: an MRO distributor keeps its order history in company storage#
Illustrative: Northgate Industrial Supply, a fictional MRO distributor, has run Prophet 21 on its own servers for many years and is moving to Epicor's cloud offering. The conversion plan covers the live database, but the IT director notices that order attachments point to a file share scheduled for retirement.
Before cutover, the team takes a full backup of the legacy database, exports the attachment folders with a manifest keyed by order number and documents every user-defined field. It keeps a read-only copy in company-owned encrypted storage, separate from the hosted environment, and records who can access it.
Later, the CEO asks whether the company's order and return history could interest AI developers. Because the archive is intact and documented, the IT director can answer a metadata-only fit check quickly: systems, years covered, record families and known restrictions.
Why the archive matters later, and how SourceX fits#
The archive matters later because order lines, returns, substitutions and notes describe how a distributor actually serves customers, the kind of linked operational record AI developers look for. A complete archive also supports audits, warranty disputes and a future sale of the business.
SourceX never hosts multi-terabyte datasets; large archives stay in your own storage or ship on encrypted drives. Under the SourceX five-step transaction, nothing moves until your company has reviewed the scope in the Rights and Preparation steps and approved the release.
The SourceX Evidence Packet then documents provenance for the exported tables, including source system and export date, alongside the rights relied on, the permitted use, the privacy treatment and your release authorization.
Frequently asked questions
Will our old P21 server data be deleted automatically?
Not automatically if it is your own server, but decommissioning plans often schedule the hardware for disposal. Make sure the backup, the attachment export and the field documentation are verified and stored elsewhere before anyone wipes the old environment.
Can we still query P21 directly after moving to the cloud?
It depends on the hosting model and your agreement. Some hosted setups limit direct database access and offer reporting tools or data extracts instead. Ask Epicor or your partner in writing before cutover, especially if important reports rely on direct queries.
How long should we keep the legacy archive?
Base it on your record retention policy, tax and audit requirements, warranty and contract periods, and any litigation holds. Many companies keep archives longer than the minimum because order history keeps its value for analysis and planning.
Should we clean the data before migrating?
Clean the masters that will drive the new system, but do not rewrite history. Merging duplicate customers or items in the live system is sensible; altering closed orders in the archive destroys evidence of what happened. Keep a raw copy before any cleanup begins.
Is distribution order history interesting to AI developers?
It can be, particularly when orders link to quotes, substitutions, returns and the notes explaining exceptions. Interest depends on depth, linkage and rights. A metadata-only fit check, with no files shared, is the usual way to find out.
What format should exported tables use?
Use open formats that any tool can read, such as CSV or a columnar format, with one file per table and a data dictionary describing each column. Keep the original keys and timestamps unchanged, and record the export date and source system in a manifest stored alongside the files.
Related resources
See if your company qualifies
A short company assessment. No data uploads are needed.