ERP migration
Field-level mapping, validation, and rollback between Epicor Eclipse and Epicor Prophet 21. We move data and schema; workflows are rebuilt natively in Epicor Prophet 21.
Epicor Eclipse
Source
Epicor Prophet 21
Destination
Compatibility
13 of 14
objects map 1:1 between Epicor Eclipse and Epicor Prophet 21.
Complexity
BStandard
Timeline
8-12 weeks
Overview
Epicor Eclipse to Epicor ERP is an intra-vendor upgrade with a specific technical complication: Eclipse runs on Rocket UniVerse, a MultiValue NoSQL database, while Epicor ERP uses a standard relational schema. That database-level difference means this migration is never a simple export-import. We extract Eclipse data through its REST API (port 5000, session-based authentication) supplemented by CSV exports and EDA dashboards, then transform UniVerse dynamic arrays and file-based records into typed Epicor ERP fields. We map Eclipse's Quote-to-Invoice workflow chain end-to-end, flagging any step that breaks in the destination before cutover. Custom UniBASIC programs, EDA configurations, and custom file dictionaries do not migrate automatically; we deliver a written inventory of these for your admin to redevelop. We do not migrate workflows, automations, EDI maps, or forms as code.
Every standard and custom field arrives verified.
AI proposes the map; you confirm before any record moves.
Parent–child, lookups, and ownership stay linked.
Calls, emails, meetings — with original timestamps.
Documents, uploads, and inline notes move with the record.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
Each row shows how a Epicor Eclipse object lands in Epicor Prophet 21, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Epicor Eclipse
CUSTOMER
Epicor Prophet 21
Customer
1:1Eclipse stores customer records in the CUSTOMER file with ship-to addresses in SHIP.TO, contacts in CONTACT, and classifications in CUSTOMER.CLASS, all stored as UniVerse dynamic arrays. We extract via the Eclipse REST API or direct file parsing, normalize multi-value address structures into Epicor ERP's standard address schema, and map customer-specific pricing classes and credit limits to CustomerPricesch熊 and CreditLimit fields. The customer number from Eclipse becomes the Epicor ERP CustomerID as the dedupe key.
Epicor Eclipse
SUPPLIER
Epicor Prophet 21
Vendor
1:1Eclipse vendor records (SUPPLIER file) include PO history, rebate terms, EDI capabilities, and multi-value buying codes. We extract the vendor master, transform vendor-specific classifications into Epicor ERP Vendor records, and preserve EDI capability flags in custom vendor fields. VENDOR.PRODUCT cross-references map to the Epicor ERP PartVendors table with vendor part numbers preserved.
Epicor Eclipse
PRODUCT
Epicor Prophet 21
Part
1:1Eclipse Part records (PRODUCT file) contain dynamic attributes, substitute/replacement chains, and warehouse-specific stocking data stored as dynamic arrays. We flatten these into Epicor ERP Part records, mapping unit-of-measure definitions from UOM, product groups from PRODUCT.GROUP, and part classifications. User-defined dictionary fields that were added via UniBASIC are flagged for manual mapping in Epicor ERP's UD field framework.
Epicor Eclipse
INVENTORY
Epicor Prophet 21
PartWhse
1:1Eclipse tracks on-hand, allocated, and on-order quantities per warehouse per part using multi-value fields in the INVENTORY file. We extract warehouse-level quantities, map bin and location data to Epicor ERP's warehouse management schema, and validate that on-hand values reconcile to Eclipse's inventory valuation report. Lot and serial number tracking data migrates to PartLot and PartBin tables with full traceability dates.
Epicor Eclipse
ORDER
Epicor Prophet 21
SalesOrder
1:1Open sales orders from Eclipse's ORDER file link to customer, part, pricing, and warehouse records. We extract order headers and line detail, preserving order-specific discounts, notes, and sales person assignments. Order dates, due dates, and ship dates transfer to Epicor ERP SalesOrderHed and SalesOrderDtl. Partially shipped orders require careful line-level status mapping to preserve fulfillment state in the destination.
Epicor Eclipse
PO
Epicor Prophet 21
PurAgent
1:1Eclipse purchase orders include vendor terms, line items, and receiving status. We extract open POs, map them to Epicor ERP PO records, and flag partially-received orders that require line-level receipt handling in the destination. PO approval workflow configurations in Eclipse do not migrate; we document the approval chain for reconstruction in Epicor ERP.
Epicor Eclipse
QUOTE
Epicor Prophet 21
QuoteHed
1:1Open quotes from Eclipse's quote file migrate to Epicor ERP QuoteHed and QuoteDtl with full line detail, pricing, and configuration data. Closed quote statistics (win/loss rates, average deal size) summarize into a migration report rather than individual records. Eclipse stores quote lines with configuration chains that require careful field-by-field mapping to Epicor ERP's quote schema.
Epicor Eclipse
GLACCT
Epicor Prophet 21
GLAccount
1:1Eclipse account structures use non-standard numbering and can embed divisions and cost centers in the same field. We extract account masters, segment them per Epicor ERP's chart of accounts structure (Company-Division-Department-Account-SubAccount), and map external account references. Historical account balances transfer to Epicor ERP's GLJrnDtl with the appropriate fiscal period assignments.
Epicor Eclipse
AR/AP
Epicor Prophet 21
InvoiceHead / VendorInvoice
1:1Outstanding invoices (AR) and vouchers (AP) are extracted with full aging data, customer/vendor references, and payment terms. We preserve open invoice totals, aging buckets, and apply-to information for reconciliation in Epicor ERP. Lockbox payments and partial payment history migrate as PaymentDtl records attached to the original invoice.
Epicor Eclipse
CUSTOMER.CLASS
Epicor Prophet 21
CustomerPriceGroup
1:1Eclipse customer classifications and pricing assignments map to Epicor ERP CustomerPriceGroup records. Price Break schedules attached to customer classes migrate to PriceLst records with effective dates preserved. This mapping is required before Customer records insert so that pricing group references are satisfied.
Epicor Eclipse
PRODUCT.GROUP
Epicor Prophet 21
ProductGroup
1:1Eclipse product categories and classifications (PRODUCT.GROUP file) map directly to Epicor ERP ProductGroup records. The category hierarchy transfers with parent-group references preserved, and each group's default stocking warehouse assignments migrate to the ProductGroup record.
Epicor Eclipse
PDA / Tax
Epicor Prophet 21
TaxRegion
1:1Tax jurisdiction assignments and rates tied to customer ship-to locations in Eclipse's tax master extract to Epicor ERP TaxRegion and TaxConn records. Any tax calculation logic embedded in custom UniBASIC programs is flagged for redeployment as BPMs in Epicor ERP, because tax engine configuration does not migrate as code.
Epicor Eclipse
DOCUMENT
Epicor Prophet 21
Document attachment records
lossyEclipse stores document images and attachments in file repositories (DOCUMENT file, Document Imaging module). We extract document references and metadata, mapping file paths and image records to Epicor ERP's attachment framework. Image files themselves require separate file transfer rather than API insertion and are flagged as a distinct step in the migration approach.
Epicor Eclipse
USER / EMPLOYEE
Epicor Prophet 21
UserAccount
1:1Eclipse user records include role assignments, warehouse access, and salesperson links. We extract the user master, map to Epicor ERP UserAccount records with role preservation, and flag inactive accounts for admin review before cutover. Salesperson assignments from Eclipse migrate to Epicor ERP SalesRep records linked to UserAccount.
| Epicor Eclipse | Epicor Prophet 21 | Compatibility | |
|---|---|---|---|
| CUSTOMER | Customer1:1 | Fully supported | |
| SUPPLIER | Vendor1:1 | Fully supported | |
| PRODUCT | Part1:1 | Fully supported | |
| INVENTORY | PartWhse1:1 | Fully supported | |
| ORDER | SalesOrder1:1 | Fully supported | |
| PO | PurAgent1:1 | Fully supported | |
| QUOTE | QuoteHed1:1 | Fully supported | |
| GLACCT | GLAccount1:1 | Fully supported | |
| AR/AP | InvoiceHead / VendorInvoice1:1 | Fully supported | |
| CUSTOMER.CLASS | CustomerPriceGroup1:1 | Fully supported | |
| PRODUCT.GROUP | ProductGroup1:1 | Fully supported | |
| PDA / Tax | TaxRegion1:1 | Fully supported | |
| DOCUMENT | Document attachment recordslossy | Fully supported | |
| USER / EMPLOYEE | UserAccount1:1 | Fully supported |
Gotchas + challenges
Platform-specific issues from each side, plus the pair-specific challenges that don't show up on either platform's page on its own.
Epicor Eclipse gotchas
UniVerse MultiValue extraction requires non-standard tools
Performance degradation post-Kinetic migration
End-to-end workflow must be validated as a chain
Historical data scoping determines migration cost
Integration connections require separate migration planning
Epicor Prophet 21 gotchas
Third-party bolt-on integrations complicate migration scope
Dirty data without standardized processes compounds migration risk
SDK customizations and BPMs may not survive platform upgrades
Report-based export only for non-technical users
Per-user pricing model requires accurate user count before migration planning
Pair-specific challenges
Migration approach
Eclipse configuration audit and extraction method selection
We document the current Eclipse configuration: version, modules licensed (Order Management, Counter/POS, Inventory, Purchasing, Financial Management, CRM, EDI, Document Imaging), custom UniBASIC programs, EDA dashboard count, Mass Load setups, and API endpoint availability. We then determine the extraction method: Eclipse REST API (session-based, port 5000) for structured master and transaction data; CSV bulk exports for high-volume items like inventory and order history; EDA dashboard exports for historical reporting data. Direct UniVerse file access via UniBASIC queries is reserved for any data not surfaced through API or CSV.
Data mapping design and UniVerse transformation logic
We design the transformation layer from Eclipse's UniVerse file structure to Epicor ERP's relational schema. This includes mapping CUSTOMER to Customer with SHIP.TO as address records, PRODUCT to Part with PRODUCT.GROUP as ProductGroup, ORDER to SalesOrder with line-level detail, and INVENTORY to PartWhse with warehouse-level quantities. Dynamic arrays in Eclipse (where multiple values are stored in a single field delimited by field marks) are flattened into separate Epicor ERP fields. Any user-defined dictionary fields in Eclipse are flagged for manual mapping to Epicor ERP UD field equivalents. This mapping document is reviewed by the customer's Eclipse admin and Epicor ERP consultant before extraction begins.
Historical data scoping and archive decision
Eclipse does not auto-purge, so years of data are available. We scope the migration with the customer upfront: open orders, open POs, and current inventory are mandatory. Sales history (typically 2-5 years), customer purchase history, and job history for warranty traceability are common inclusions. Complete invoice history, payment history, and archived document images are optional and add cost and extraction time. Historical data that is required for compliance but not for day-to-day operations is a candidate for archive rather than live migration into Epicor ERP, keeping the new system lean and performant.
Sandbox migration and reconciliation
We run a full migration into an Epicor ERP Sandbox using representative data volume. The customer's operations and finance leads reconcile record counts (Customers in, Vendors in, Parts in, Orders in, Inventory balances, GL account totals), spot-check 25-50 records against the Eclipse source, and validate that the Quote-to-Invoice workflow chain functions in the sandbox environment. Any mapping corrections, missing field assignments, or workflow breaks are resolved here before production migration begins. This step also validates extraction throughput so that production timelines are realistic.
Production migration in dependency order
We run production migration in record-dependency order: ProductGroups and CustomerPriceGroups (no dependencies), Parts (with UOM definitions), Vendors, Customers (with ship-to addresses and contacts), PartWhse (inventory with warehouse and bin data), open Sales Orders (with customer and part lookups resolved), open Purchase Orders (with vendor lookups resolved), Quotes, GL Account structure, open AR/AP invoices, and historical transactions last. Each phase emits a row-count and value reconciliation report before the next phase begins. The Eclipse system remains live during migration so that any new transactions during the migration window are captured in a final delta pass before cutover.
Cutover, workflow validation, and custom program handoff
We freeze Eclipse writes during cutover, run a final delta migration, then validate the full Quote-to-Invoice chain in Epicor ERP with a live test order. Financial totals (AR/AP aging, inventory value, GL trial balance) reconcile to Eclipse pre-cutover reports. We deliver the inventory of custom UniBASIC programs, EDA dashboards, and EDI maps requiring rebuild to the customer's Epicor ERP admin team, with recommended redevelopment paths. We support a one-week hypercare window for reconciliation issues. We do not rebuild UniBASIC programs as Epicor ERP BPMs within the migration scope; that is a separate development engagement.
Platform deep dives
Epicor Eclipse
Source
Strengths
Weaknesses
Epicor Prophet 21
Destination
Strengths
Weaknesses
Complexity grading
Standard ERP migration. 3 of 8 objects need a mapping; the rest are 1:1.
Overall complexity
Standard migration
Derived from compatibility, mapping clarity, API constraints, and data volume across Epicor Eclipse and Epicor Prophet 21.
Object compatibility
3 of 8 objects need a mapping; the rest are 1:1.
Field mapping clarity
Field mapping is derived from defaults — final spec confirmed during the sample migration.
Timeline complexity
8-object category — typical timelines run 2–7 days end-to-end.
API constraints
Epicor Eclipse: Rate limiting settings exist on the app server but are not publicly documented by Epicor.
Data volume sensitivity
Epicor Eclipse doesn't expose a bulk API — REST + parallelization used for high-volume runs.
Estimator
Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.
Step 1
Pick a category, then your source and destination platforms.
Category
FAQ
Answers to the questions buyers ask most during Epicor Eclipse to Epicor Prophet 21 migration scoping. Not seeing yours? Book a call.
Walk through your Epicor Eclipse to Epicor Prophet 21 migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Epicor Eclipse
Other ways to arrive at Epicor Prophet 21
Ready when you are
Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.