ERP migration
Field-level mapping, validation, and rollback between Aptean SouthWare and Epicor Prophet 21. We move data and schema; workflows are rebuilt natively in Epicor Prophet 21.
Aptean SouthWare
Source
Epicor Prophet 21
Destination
Compatibility
13 of 15
objects map 1:1 between Aptean SouthWare and Epicor Prophet 21.
Complexity
BStandard
Timeline
4-8 weeks
Overview
Moving from Aptean SouthWare to Epicor ERP is a platform-scale migration that requires handling SouthWare's file-based named-file architecture, its industry-gated export formats, and its posted versus unposted transaction states. SouthWare organizes data around named files (Customers, Vendors, Items, GL, Orders) without a public REST API, meaning most extractions require direct database queries or custom file-generation routines that vary by industry edition. Epicor ERP (Kinetic for manufacturing, Prophet 21 for distribution) uses a modern REST and OData API with company, plant, and warehouse segmentation that must be designed before import. We map SouthWare Job Cost structures to Epicor Project or Job records, preserve the posted versus unposted split across GL and Orders, handle pre-closed fiscal year balances as read-only snapshots, and produce a file manifest for attachment references that live outside the database. Workflows, automations, and ImportMate configurations do not migrate; we deliver a written inventory of these for the customer to rebuild in Epicor.
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 Aptean SouthWare 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.
Aptean SouthWare
Customer
Epicor Prophet 21
Customer
1:1SouthWare Customer master records map to Epicor Customer. The SouthWare Customer file carries address, contact, credit limit, and payment terms fields. We map these to Epicor Customer.Name, Customer.CustID, Customer.Address fields, and Customer.TaxRegion. Credit limit and payment terms migrate as Customer records are extended. Ship-to addresses from SouthWare's multiple ShipTo records per Customer map to Epicor CustomerShipTo records via the ShipTo lookup relationship.
Aptean SouthWare
Vendor
Epicor Prophet 21
Supplier
1:1SouthWare Vendor records include address, 1099 settings, and accounts payable terms. These map to Epicor Supplier records with VendorName as Supplier.Name, VendorID as Supplier.VendorID, and 1099 data into Supplier.TaxpayerID and Supplier.TaxRegion. The vendor-to-item cross-reference relationships migrate separately as SupplierPart records if the customer uses vendor-managed catalog data in Epicor.
Aptean SouthWare
Item
Epicor Prophet 21
Part
1:1SouthWare Item records include description, cost, price, unit of measure, and warehouse tracking. These map to Epicor Part records (Part.PartNum, Part.SearchDescription, Part.ProdCode, Part.TypeCode). Assembly BOM and kit structures require decomposition: SouthWare kit parents and their component line items decompose into Epicor Part.BOM and Part structure records. Lot and serial tracking settings from SouthWare migrate to Epicor Part.LotSharge and Part.SerialTracking configuration.
Aptean SouthWare
Open AP
Epicor Prophet 21
APInvoice / APAdjust
1:1SouthWare open AP invoices, credit memos, and payment applications carry open/closed status that must be preserved. We map outstanding AP records to Epicor APInvoice (invoices and credit memos) and APAdjust (payment applications). The open/closed status in SouthWare determines whether the Epicor record posts to an open fiscal period or is held. Vendor lookup resolution is required because Epicor APInvoice references Supplier by SupplierNum internally.
Aptean SouthWare
Open AR
Epicor Prophet 21
ARInvoice / ARAdjust
1:1SouthWare open AR invoices, credit memos, and payment applications migrate to Epicor ARInvoice and ARAdjust. We separate posted from unposted AR records and map the payment terms to Epicor ARInvoice.Terms. Customer lookup by Customer.CustID resolves the parent Customer reference at migration time. Unapplied credit memos become ARInvoice records with negative DocTotalAmt.
Aptean SouthWare
General Ledger
Epicor Prophet 21
GLAccount + GLAcctHist
1:1SouthWare GL records include journal entries, account balances, and cashflow ledger entries. We map account codes to Epicor GLAccount by parsing the SouthWare account structure into Epicor's segment schema (typically Account Segment + Division or Cost Center). Pre-closed fiscal years are migrated as GLAcctHist balance snapshots (read-only) rather than individual journal lines. Open and Adjusting period records migrate as GLJrnEntry lines with period status matching Epicor's open period rules.
Aptean SouthWare
Sales Order
Epicor Prophet 21
OrderHed + OrderDtl
1:1SouthWare Sales Orders map to Epicor OrderHed (order header) and OrderDtl (order lines). We separate posted versus unposted orders: posted orders migrate as closed or completed records; unposted orders migrate as open orders in Epicor's OrderHed with OrderLine carry-forward. Order status from SouthWare maps to Epicor OrderHed.OrderRel: pending, released, partial ship, and shipped states have distinct Epicor lifecycle mappings. Customer and product lookups resolve via CustNum and PartNum at migration time.
Aptean SouthWare
Purchase Order
Epicor Prophet 21
POHeader + PODetail
1:1SouthWare Purchase Orders map to Epicor POHeader and PODetail. Vendor lookup resolves via VendorNum. Order status (open, partial receipt, closed) maps to Epicor POHeader.POStatus and PODetail.POLineLineDesc. Lines without receipt in SouthWare import as open PO lines; fully received lines import as closed with receipt history if the customer requests historical completeness.
Aptean SouthWare
Inventory
Epicor Prophet 21
PartBin
1:1SouthWare warehouse tracking, quantity on hand, and bin locations migrate to Epicor PartBin records. Each SouthWare warehouse code maps to a Plant in Epicor (Epicor supports multi-plant configuration). Bin locations from SouthWare map to PartBin.BinNum. Assembly Work Order inventory and Equipment Rental Management sub-types migrate as separate PartBin records or as JobMtl/JobOper entries if the destination is Epicor Kinetic with job tracking enabled.
Aptean SouthWare
Job Cost
Epicor Prophet 21
Project + JobMtl + JobOper
1:manySouthWare Job Cost records track project-level profitability with phase-level tracking. These map to Epicor Project records (Project.ProjectID, Project.Description, Project.StartDate, Project.DueDate) with phases as ProjectPhase records. Phase-level revenue and cost rollups from SouthWare map to ProjectPhase.BurdenedCost and ProjectPhase.Revenue. If the customer uses Epicor's job-tracking model for manufacturing, SouthWare job cost records map to JobMtl and JobOper entries under a JobHead record.
Aptean SouthWare
Service Order
Epicor Prophet 21
FSContHead + FSSched
1:1SouthWare Service Orders with dispatch scheduling, technician assignment, repair history, and warranty references map to Epicor FieldService records (FSContHead for service contracts and FSSched for scheduling). Warranty lookup references migrate as FSContract records. If the destination Epicor edition does not include FieldService, service order headers and line items map to OrderHed and OrderDtl with a service-specific OrderType, and we flag this configuration gap in the handoff document.
Aptean SouthWare
Payroll
Epicor Prophet 21
Prhdr + PREmpDed
1:1SouthWare payroll history includes earnings, deductions, and tax withheld. Current-period and year-to-date figures migrate to Epicor Payroll records (Prhdr header and PREmpDed detail lines). FICA and tax data require careful tax code mapping: SouthWare tax codes map to Epicor TaxRegion and TaxCode combinations. Employee records link via EmpNum lookup resolved by employee ID matching. Pre-closed payroll years are migrated as historical read-only records matching Epicor's payroll history cutoff rules.
Aptean SouthWare
Fixed Assets
Epicor Prophet 21
FaHdGen + FaTran
1:1SouthWare Fixed Asset registers, depreciation schedules, and asset classifications map to Epicor FaHdGen (asset header) and FaTran (depreciation transactions). Accumulated depreciation and book value migrate to FaHdGen.AssetBal and FaHdGen.AcqCost. Asset classification codes from SouthWare map to FaHdGen.ClassCode and FaHdGen.ParentNum for asset hierarchies. Depreciation method (straight-line, declining balance) migrates to FaTran.Calculated and FaTran.DeprMethod.
Aptean SouthWare
Custom Objects (Field-Level Objects)
Epicor Prophet 21
UD Column + Custom Field
lossySouthWare Field-Level Objects and custom Field Filters added via its Objects feature are discovered during data profiling. We map each discovered custom field to an Epicor UD Column on the appropriate table (UD Column Map). The mapping is one custom object to one or more UD Column entries depending on the field type. Customer must enable UD Fields in Epicor System Setup before migration. This step adds a dedicated profiling sprint to the project timeline because custom objects are not visible in SouthWare standard data dictionaries.
Aptean SouthWare
Attachment file references
Epicor Prophet 21
File manifest (no binary migration)
1:1SouthWare stores document attachments as files on the application server rather than as database BLOBs. We do not migrate binary attachments. We export a file manifest listing every attachment reference: document type, record link, file path on the SouthWare server, file name, and last-modified date. The customer uses this manifest to manually transfer, archive, or link files post-migration. If Epicor contains a document management module (EDMS), we provide a mapping from the manifest to Epicor Document records.
| Aptean SouthWare | Epicor Prophet 21 | Compatibility | |
|---|---|---|---|
| Customer | Customer1:1 | Fully supported | |
| Vendor | Supplier1:1 | Fully supported | |
| Item | Part1:1 | Fully supported | |
| Open AP | APInvoice / APAdjust1:1 | Fully supported | |
| Open AR | ARInvoice / ARAdjust1:1 | Fully supported | |
| General Ledger | GLAccount + GLAcctHist1:1 | Mapping required | |
| Sales Order | OrderHed + OrderDtl1:1 | Fully supported | |
| Purchase Order | POHeader + PODetail1:1 | Fully supported | |
| Inventory | PartBin1:1 | Fully supported | |
| Job Cost | Project + JobMtl + JobOper1:many | Mapping required | |
| Service Order | FSContHead + FSSched1:1 | Fully supported | |
| Payroll | Prhdr + PREmpDed1:1 | Mapping required | |
| Fixed Assets | FaHdGen + FaTran1:1 | Fully supported | |
| Custom Objects (Field-Level Objects) | UD Column + Custom Fieldlossy | Mapping required | |
| Attachment file references | File manifest (no binary migration)1: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.
Aptean SouthWare gotchas
Industry-gated data export formats
Posted vs. unposted transaction states control migration validity
Pre-closed fiscal years lock GL history
Custom Objects discovered only during data profiling
Attachment files live outside the database
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
Discovery and data profiling
We audit the source SouthWare system across industry edition, installed modules (GL, AP, AR, Payroll, Inventory, Orders, Job Cost, Service, Fixed Assets), custom Field-Level Objects, active versus closed transaction counts, and pre-closed fiscal year list. We request read-only database access to the SouthWare server and run metadata discovery queries to enumerate every named file, custom field, and field filter. The discovery output is a written migration scope document covering record counts per object, identified custom extraction requirements, and a list of any SouthWare modules not present in the Epicor target edition (for example, FieldService gaps). We pair this with an Epicor edition assessment: Kinetic for discrete manufacturing, Prophet 21 for distribution, or Lumber and Building Materials for vertical markets.
Schema design and segment mapping
We design the destination schema in Epicor. This includes configuring the Chart of Accounts segment structure (Epicor supports multi-segment GLAccount with COA segments for company, division, department, and account), mapping SouthWare account codes to Epicor GLAccount segment values, provisioning plants and warehouses (Epicor multi-plant configuration), configuring Part number segments and UD fields for custom Field-Level Object mapping, and setting up GL Period Status for open and pre-closed year handling. The schema design is validated against the Epicor target environment (Sandbox or Pilot) before any data load begins.
Custom extraction build and validation
For SouthWare file types not accessible via standard export, we build custom extraction queries against the SouthWare database. These queries produce CSV or fixed-width extract files in the format required for Epicor import. We validate extract output against the source database by spot-checking 25-50 records per object type. The extraction scripts are documented and handed off to the customer for use in future audits or re-extraction if needed. Any SouthWare file types with complex structures (kit assemblies, lot-controlled items, multi-warehouse inventory) receive dedicated extraction specifications during this phase.
Sandbox migration and reconciliation
We run a full migration into the Epicor Sandbox environment using production-like data volumes. The customer's finance, operations, and IT leads reconcile record counts per object (Customers in, Vendors in, Parts in, open AP and AR in, GL balances per year, Orders per status, Job Cost phases in), spot-check 30-50 records per object type against the SouthWare source, and validate Epicor posting workflows for GL, AR, and AP. The posted versus unposted split is validated at this stage. Any mapping corrections happen in Sandbox before production migration begins.
Production migration in dependency order
We run production migration in record-dependency sequence. GL accounts and open/closed period status come first. Customers and vendors load next with their address and payment terms resolved. Parts and BOM structures follow. Open AP and AR load with vendor and customer lookups resolved. Orders and Job Cost phases load with customer and part references satisfied. Payroll and Fixed Assets load as historical snapshots for closed periods. Custom Field-Level Objects load last. Each phase emits a row-count reconciliation report before the next phase begins. We apply Epicor GL Period Status checks before committing any GL import.
Cutover, validation, and automation rebuild handoff
We freeze SouthWare writes during the cutover window, run a final delta migration of any records modified during the migration window, then enable Epicor as the system of record. We deliver the Workflow, BPM, and ImportMate configuration inventory document to the customer's Epicor admin team for rebuild. We do not rebuild SouthWare automations as Epicor Data Directive or BPMs inside the migration scope; that is a separate engagement or an internal admin task. We support a one-week post-cutover window where we resolve reconciliation issues raised by the customer's team.
Platform deep dives
Aptean SouthWare
Source
Strengths
Weaknesses
Epicor Prophet 21
Destination
Strengths
Weaknesses
Complexity grading
Standard ERP migration. 2 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 Aptean SouthWare and Epicor Prophet 21.
Object compatibility
2 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
Aptean SouthWare: Not publicly documented.
Data volume sensitivity
Aptean SouthWare 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 Aptean SouthWare to Epicor Prophet 21 migration scoping. Not seeing yours? Book a call.
Walk through your Aptean SouthWare 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 Aptean SouthWare
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.