ERP migration
Field-level mapping, validation, and rollback between Xledger and Acumatica. We move data and schema; workflows are rebuilt natively in Acumatica.
Xledger
Source
Acumatica
Destination
Compatibility
14 of 14
objects map 1:1 between Xledger and Acumatica.
Complexity
BStandard
Timeline
3–10 business days
Overview
Xledger and Acumatica take different approaches to organizational structure and financial data storage. Xledger organizes data in a multi-entity hierarchy where each entity represents a separate legal or operational unit, and account codes often embed segment values directly. Acumatica uses a company and branch model where the chart of accounts is managed separately from segment definitions, and accounts are referenced by ID rather than embedded codes. This architectural gap is the central challenge in any Xledger-to-Acumatica migration. We map the full chart of accounts with account group assignments, complete GL journal entry history with all line-level detail and descriptions, vendor and customer master records with payment terms and tax registration IDs, AP and AR transaction documents with original invoice dates and due dates, inventory items with unit-of-measure conversions, and project cost entries with cost code assignments. Xledger workflows and approval chains do not migrate because Acumatica's Automation Engine and generic inquiry framework operate differently — these must be rebuilt manually. Financial reports and dashboards also do not transfer. For the migration mechanism, we connect to Xledger through its GraphQL API, extract records based on the entity and account structure we audit, transform data to Acumatica's DAC-based schema, and load through Acumatica's import scenarios. A delta-pickup window captures any records modified or added in Xledger during the cutover period.
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 Xledger object lands in Acumatica, including any object-level transformations, lookup resolution, or schema-design dependencies.
Typical mapping — final map is confirmed during the sample migration step.
Xledger
Entity
Acumatica
Company / Branch
1:1Xledger's multi-entity hierarchy maps to Acumatica's company record structure. Each Xledger entity becomes an Acumatica company. If Xledger uses deep intercompany hierarchies, the structure may need flattening or translation to Acumatica branch records. We deliver an entity-to-company mapping plan before migration so the Acumatica organizational structure is defined first.
Xledger
Chart of Accounts (Account Code + Description)
Acumatica
Account (AccountCode, Description, AccountGroup)
1:1Xledger account codes and descriptions map directly to Acumatica AccountCode and Description fields. Account groups from Xledger map to Acumatica Account Groups for financial statement grouping. The complexity arises when Xledger embeds segment values in account codes — we extract those and either flatten them into subaccounts or use Acumatica's segment codes feature, depending on your accounting team preference.
Xledger
Vendor / Supplier
Acumatica
Vendor (VendorID, VendorName, PaymentInfo)
1:1Xledger vendor records map to Acumatica Vendor DAC with all payment terms, tax registration IDs, and RemitAddress details preserved. Xledger vendors assigned to multiple entities require decisions about consolidation or intercompany configuration in Acumatica before migration, since Acumatica vendors are tied to one company record.
Xledger
Customer
Acumatica
Customer (CustomerID, CustomerName, CustomerClass)
1:1Xledger customer records migrate to Acumatica Customer DAC with name, class, credit limit, and tax registration fields. As with vendors, Xledger's multi-entity customer assignments require restructuring in Acumatica's single-company model — we map one primary company per customer and surface the multi-entity assignments as a reference field for reconciliation.
Xledger
Bank Account / Payment Method
Acumatica
Cash Account / Payment Method
1:1Xledger bank account configurations and payment methods map to Acumatica CashAccount records and PaymentMethod settings. Subaccount numbering alignment is verified before migration since mismatched subaccount structures can cause bank reconciliation failures post-migration. We cross-reference Xledger's bank account assignments against Acumatica's cash account chart to ensure all payment flows route correctly through the appropriate accounts and branches.
Xledger
GL Batch / Journal Entry (Header + Lines)
Acumatica
Batch / Journal Transaction (BatchNbr + RefNbr)
1:1Xledger GL batches and journal lines with full line-level descriptions and reference document numbers map to Acumatica Batch and GLTran records. BatchNbr in Acumatica corresponds to Xledger's batch identifier; RefNbr maps to the journal entry or source document reference. We preserve all debit and credit line amounts with original transaction dates and descriptions.
Xledger
AP Invoice / Bill
Acumatica
AP Invoice (APInvoice)
1:1Xledger AP documents migrate to Acumatica APInvoice DAC with original invoice dates, due dates, vendor references, and line-level amounts. Open AP documents map with status Open; fully paid invoices migrate as Closed. The batch structure from Xledger is flattened into individual Acumatica invoice records during import.
Xledger
AR Invoice
Acumatica
AR Invoice (ARInvoice)
1:1Xledger AR documents migrate to Acumatica ARInvoice DAC with customer references, invoice dates, due dates, and line-level amounts preserved. Invoice type and status map from Xledger document states to Acumatica's Open/Closed status field. We verify outstanding AR totals match between systems before and after migration.
Xledger
Inventory Item
Acumatica
Inventory Item (InventoryItem)
1:1Xledger inventory items with stock item flag, unit of measure, and standard cost map to Acumatica InventoryItem DAC. Unit-of-measure conversions are preserved through Acumatica's UOM conversion table. Warehouse assignments in Xledger are mapped to Acumatica branches, which requires clarification on how Xledger's entity-level warehouse configuration should translate.
Xledger
Project / Project Cost Entry
Acumatica
Project / ProjectTransaction (PMProject, PMTran)
1:1Xledger project records and cost entries map to Acumatica's Project Management module — PMProject for project headers and PMTran for individual cost transactions with cost code, cost type, and amount. Project templates in Xledger become Acumatica project templates. We preserve original cost entry dates and cost code assignments for project billing continuity.
Xledger
User-Defined Field / Custom Property
Acumatica
DAC Extension (Usr prefix fields)
1:1Xledger custom object values defined through its object value schema map to Acumatica custom fields on the relevant DAC extension. These require a customization project in Acumatica to be defined before migration runs. We audit Xledger's custom field usage and produce an Acumatica customization project specification as part of the migration plan.
Xledger
Workflow / Approval Chain
Acumatica
Not Migrated (Manual Rebuild Required)
1:1Xledger workflow definitions for approval chains, posting approvals, and intercompany workflows have no direct equivalent in Acumatica. Acumatica uses its Automation Engine and generic inquiry framework for similar logic, but workflows must be redesigned and built manually in Acumatica. We export Xledger workflow definitions as a reference document to support the Acumatica rebuild effort.
Xledger
Report / Dashboard
Acumatica
Not Migrated (Manual Rebuild Required)
1:1Xledger custom reports and dashboards built on its flex screen and reporting module do not transfer to Acumatica, which uses its own report designer, Generic Inquiries, and BI connector. Underlying data migrates so reports can be rebuilt in Acumatica's framework, but the report objects themselves require manual recreation.
Xledger
Attachment / File
Acumatica
Note / Attachment (NoteDoc)
1:1Files attached to Xledger records (vendor documents, invoice attachments, project files) are re-uploaded to Acumatica's Note and Attachment DAC linked to the corresponding migrated record. File size limits per Acumatica's attachment configuration apply, and inline images in notes are extracted and rehosted.
| Xledger | Acumatica | Compatibility | |
|---|---|---|---|
| Entity | Company / Branch1:1 | Fully supported | |
| Chart of Accounts (Account Code + Description) | Account (AccountCode, Description, AccountGroup)1:1 | Fully supported | |
| Vendor / Supplier | Vendor (VendorID, VendorName, PaymentInfo)1:1 | Fully supported | |
| Customer | Customer (CustomerID, CustomerName, CustomerClass)1:1 | Fully supported | |
| Bank Account / Payment Method | Cash Account / Payment Method1:1 | Fully supported | |
| GL Batch / Journal Entry (Header + Lines) | Batch / Journal Transaction (BatchNbr + RefNbr)1:1 | Fully supported | |
| AP Invoice / Bill | AP Invoice (APInvoice)1:1 | Fully supported | |
| AR Invoice | AR Invoice (ARInvoice)1:1 | Fully supported | |
| Inventory Item | Inventory Item (InventoryItem)1:1 | Fully supported | |
| Project / Project Cost Entry | Project / ProjectTransaction (PMProject, PMTran)1:1 | Fully supported | |
| User-Defined Field / Custom Property | DAC Extension (Usr prefix fields)1:1 | Fully supported | |
| Workflow / Approval Chain | Not Migrated (Manual Rebuild Required)1:1 | Fully supported | |
| Report / Dashboard | Not Migrated (Manual Rebuild Required)1:1 | Fully supported | |
| Attachment / File | Note / Attachment (NoteDoc)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.
Xledger gotchas
Multi-entity intercompany journal entries require careful cross-mapping
Historical AP/AR records map to invoice-level objects, not account balances
Workflow and approval configurations are custom and non-transferable
ERP implementations extend well beyond the initial migration window
Built-in integrations are Xledger-side only and require separate destination-side configuration
Acumatica gotchas
API user licenses cap concurrent sessions and request throughput
Multi-tenant filtering requires CompanyID awareness
Custom fields require separate discovery before field mapping
Notes and attachments use a separate linked table structure
Implementation timelines frequently run 3–9 months end-to-end
Pair-specific challenges
Migration approach
Audit Xledger schema and plan Acumatica structure
We connect to Xledger read-only and inventory the entity hierarchy, chart of accounts structure, account code patterns, vendor and customer master record count, and transaction volumes across GL, AP, AR, inventory, and project modules. We simultaneously map these to Acumatica's company, branch, and account structure. This phase produces a data migration plan specifying which Xledger entities map to which Acumatica companies, how embedded account codes are handled, and which subledgers require Migration Mode activation.
Define Acumatica custom fields and enable migration settings
Based on the audit, we create Acumatica customization projects for any DAC extensions required to hold Xledger user-defined fields and custom object values. We also activate Migration Mode in all relevant subledgers (AR, AP, GL) via Acumatica's preferences screens. This ensures Acumatica will accept imported historical records without triggering standard document validation errors. The schema must be ready before any transactional data lands.
Run sample migration with field-level diff
We migrate a representative slice — typically 200–500 records covering accounts, vendors, customers, a batch of GL entries, sample AP and AR documents, a few inventory items, and one project — and produce a field-level diff comparing source values against Acumatica field values. This validates that account code mapping, entity-to-company routing, payment term translations, and transaction status conversions are correct before committing to a full run. Any mis-mappings are corrected in the migration scripts before proceeding.
Execute full migration in staged sequence
The full migration runs in dependency order: first the chart of accounts and account groups, then vendors and customers, then inventory items and project headers, then GL journal batches, then AP and AR documents, then project cost entries. Each stage is validated before the next begins. API call rates are managed to stay within Acumatica's license-tier limits. We monitor Acumatica's import scenario logs and error queues throughout. A delta-pickup window runs concurrently to capture any records created or modified in Xledger during the migration.
Reconcile and validate migrated data
We run a reconciliation check comparing record counts, account balance totals, vendor and customer outstanding balances, and open AP/AR document counts between Xledger and Acumatica. Any discrepancies are flagged and corrected before the cutover is declared complete. We deliver an audit log of every record imported, its source ID from Xledger, and its destination ID in Acumatica. One-click rollback is available if reconciliation uncovers systemic issues. We also deliver a workflow rebuild reference document and a report rebuild checklist so your team can prioritize the manual rebuild of automations and reports in Acumatica.
Platform deep dives
Xledger
Source
Strengths
Weaknesses
Acumatica
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 Xledger and Acumatica.
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
Xledger: Not publicly documented.
Data volume sensitivity
Xledger 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 Xledger to Acumatica migration scoping. Not seeing yours? Book a call.
Walk through your Xledger to Acumatica migration with a real engineer — 30 minutes, free, written quote within 24 hours.
Book a free 30 minute consultationAdjacent paths
Other ways to leave Xledger
Other ways to arrive at Acumatica
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.