ERP migration

Migrate from Epicor Eclipse to Dolibarr ERP

Field-level mapping, validation, and rollback between Epicor Eclipse and Dolibarr ERP. We move data and schema; workflows are rebuilt natively in Dolibarr ERP.

Epicor Eclipse logo

Epicor Eclipse

Source

Dolibarr ERP

Destination

Dolibarr ERP logo

Compatibility

100%

12 of 12

objects map 1:1 between Epicor Eclipse and Dolibarr ERP.

Complexity

BStandard

Timeline

5-8 weeks

Rollback included Accuracy guarantee Field-level validation

Overview

What this migration involves

Moving from Epicor Eclipse to Dolibarr is a structural migration that must address Eclipse's UniVerse MultiValue architecture before any data reaches a relational database. Eclipse stores customer records, parts, pricing matrices, and orders in file-based dynamic arrays that do not map 1:1 to Dolibarr's normalized MySQL/PostgreSQL schema. We extract via Eclipse's REST API or direct UniVerse file access, flatten dynamic array fields into standard columns, and load through Dolibarr's native import tools or REST API. Open Sales Orders and Open Purchase Orders carry the highest risk because Eclipse's order-to-invoice chain is tightly linked; we validate the full sequence post-load. Dolibarr's modular architecture means we activate only the modules needed for the migrated data (ThirdParty, Product, Order, Stock, Accounting) and we flag which distribution-specific features (counter/POS, RF scanning, cross-docking) have no native Dolibarr equivalent and require manual configuration or third-party modules. Workflows, custom UniBASIC programs, EDA dashboards, and EDI configurations do not migrate; we deliver a written inventory of these for the customer's team to address post-cutover.

Field-level fidelity

Every standard and custom field arrives verified.

Schema-aware mapping

AI proposes the map; you confirm before any record moves.

Relationships preserved

Parent–child, lookups, and ownership stay linked.

Full activity history

Calls, emails, meetings — with original timestamps.

Attachments & notes

Documents, uploads, and inline notes move with the record.

Why teams make this switch

Two sides of the same decision

Leaving

Epicor Eclipse logo

Epicor Eclipse

What's pushing teams away

  • Eclipse lacks a true cloud-native version, pushing organizations toward Kinetic or competing cloud ERPs for scalability and remote access.
  • The character-based green screen interface feels outdated compared to modern web-based ERPs, creating friction for new employees and remote teams.
  • Limited built-in reporting and analytics capabilities require significant customization or third-party tools to gain actionable insights.
  • Integration with modern CRM, e-commerce, and MES systems is challenging without custom development, creating data silos.
  • Rising per-user costs ($120-200/month) and implementation fees drive organizations to evaluate lower-cost cloud alternatives.

Choosing

Dolibarr ERP logo

Dolibarr ERP

What's pulling them in

  • Free open-source core with no per-user license fee makes it the lowest-cost entry point for small teams needing ERP and CRM in one package.
  • Self-hosted deployment gives full data ownership and eliminates vendor lock-in, especially attractive to businesses with compliance requirements.
  • Modular architecture means teams enable only the features they use, keeping the interface uncluttered and reducing learning curve.
  • Fast installation with no technical knowledge required — one reviewer set up multiple businesses in minutes using their own hosting.
  • Active community forum and marketplace of third-party add-ons provide support and extension options without mandatory subscription costs.

Object mapping

How Epicor Eclipse objects map to Dolibarr ERP

Each row shows how a Epicor Eclipse object lands in Dolibarr ERP, 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

maps to

Dolibarr ERP

ThirdParty (type: Customer)

1:1
Fully supported

Eclipse CUSTOMER records map to Dolibarr ThirdParty entries with type=Customer. Eclipse ship-to addresses stored in SHIP.TO files map to Dolibarr address records linked to the parent ThirdParty. Eclipse customer class and price class fields map to Dolibarr price level or category. We flatten dynamic array address fields (street, city, state, zip, country) into standard Dolibarr address table columns and validate against Dolibarr's country and state/province picklists.

Epicor Eclipse

Supplier

maps to

Dolibarr ERP

ThirdParty (type: Supplier)

1:1
Fully supported

Eclipse vendor records from the VENDOR file map to Dolibarr ThirdParty entries with type=Supplier. Eclipse PO history, rebate terms, and EDI capability flags transfer as supplier notes or custom fields. We map Eclipse buying codes (VENDOR.PRODUCT cross-references) to Dolibarr supplier product references so that purchase orders can display both Eclipse part numbers and vendor part numbers.

Epicor Eclipse

Part / Product

maps to

Dolibarr ERP

Product (or Service)

1:1
Fully supported

Eclipse PRODUCT records map to Dolibarr Product entries with type=Product (for physical goods) or type=Service (for non-stocked items). Eclipse dynamic array attributes—warehouse-specific stocking data, substitute chains, product group assignments—require flattening into Dolibarr product custom fields or multi-line text notes. Eclipse UOM definitions map to Dolibarr unit of measure entries. If the customer uses Eclipse's IDW (Industry Data Warehouse) attributes for electrical distribution, we flag these for manual configuration in Dolibarr because IDW is an Eclipse-specific taxonomy with no direct Dolibarr equivalent.

Epicor Eclipse

Open Sales Order

maps to

Dolibarr ERP

Order

1:1
Fully supported

Open Eclipse orders map to Dolibarr CustomerOrder records with status in progress. Eclipse order headers contain customer reference, order date, terms, and salesperson; these map to Dolibarr Order fields directly. Eclipse order lines map to OrderLine records with product reference, quantity, unit price, and discount. We preserve customer-specific pricing and quantity breaks from Eclipse as Dolibarr line-level prices. Eclipse order notes and special instructions transfer as Dolibarr Order notes.

Epicor Eclipse

Open Purchase Order

maps to

Dolibarr ERP

SupplierOrder

1:1
Fully supported

Open Eclipse POs map to Dolibarr SupplierOrder entries. Eclipse PO fields (vendor, terms, line items, receiving status) map to Dolibarr SupplierOrder fields. Partially-received Eclipse POs require careful line-level tracking because Dolibarr's receiving workflow is simpler than Eclipse's multi-stage receiving and inspection process; we flag any partially-received lines that need special handling during cutover validation.

Epicor Eclipse

Inventory / Stock

maps to

Dolibarr ERP

Stock

1:1
Mapping required

Eclipse INVENTORY records by warehouse map to Dolibarr Stock entries per warehouse. Eclipse bin locations and rankings map to Dolibarr warehouse location fields. On-hand, allocated, and on-order quantities per warehouse per part transfer as Dolibarr stock values. Eclipse multi-value fields that store multiple quantity types per part require unpacking into separate Dolibarr stock entries per status. We validate total inventory value post-load against Eclipse's inventory valuation report.

Epicor Eclipse

Chart of Accounts

maps to

Dolibarr ERP

Account (Accounting module)

1:1
Mapping required

Eclipse account structures (which may combine division, cost center, and account number in one field) must be segmented and mapped to Dolibarr's accounting chart. Dolibarr's accounting module supports standard chart of accounts templates (PCG82 for France, generic templates for other countries) that we customize with the customer's Eclipse account structure. Eclipse cost center usage determines whether we create Dolibarr cost center dimensions as separate accounts or as analytical dimensions.

Epicor Eclipse

Open AR / AP

maps to

Dolibarr ERP

Invoice (or Bill) and Payment

1:1
Mapping required

Outstanding Eclipse AR invoices map to Dolibarr CustomerInvoice records with status unpaid. Eclipse AP vouchers map to Dolibarr SupplierInvoice (Bill) records. Aging data and payment terms transfer as invoice metadata. Eclipse apply-to information (which payments were allocated to which invoices) requires mapping to Dolibarr payment allocations. We validate that total AR and AP balances match Eclipse's aging report before declaring the migration phase complete.

Epicor Eclipse

Historical Transactions

maps to

Dolibarr ERP

Invoice and Order (closed)

1:1
Mapping required

Scoping determines which historical records migrate. We typically migrate 2-5 years of sales history (orders, invoices, payments, RMAs) per the customer's requirements. Eclipse closed orders older than the retention period are summarized or excluded. Complete invoice and payment history is optional and adds cost because of volume. We document the scope upfront and validate historical totals against Eclipse's period-end reports.

Epicor Eclipse

Quote / Estimate

maps to

Dolibarr ERP

Propal (Commercial Proposal)

1:1
Fully supported

Open Eclipse quotes map to Dolibarr Propal records. Eclipse quote lines with configuration details and quantity break pricing transfer as Dolibarr PropalLine entries. Closed quote statistics (win rate, average value) migrate as summary records in a custom field or note because Dolibarr does not have a native closed-quote history object. Quote expiration dates and status transfer to Propal validity dates and status.

Epicor Eclipse

Tax Code

maps to

Dolibarr ERP

Tax (VAT or local tax rules)

1:1
Fully supported

Eclipse tax jurisdiction assignments tied to customer ship-to locations map to Dolibarr tax rules per customer and per product category. Eclipse tax codes embedded in custom UniBASIC programs are flagged for manual configuration in Dolibarr's tax management module. We export the Eclipse tax code master and jurisdiction mappings as a CSV that the customer's admin imports into Dolibarr's tax rules table.

Epicor Eclipse

Employee / User

maps to

Dolibarr ERP

User

1:1
Fully supported

Eclipse user records (with role assignments, warehouse access, and salesperson links) map to Dolibarr User entries. Eclipse salesperson codes transfer as Dolibarr user tags or custom fields so that orders and quotes can be attributed to the correct salesperson. We extract user status (active/inactive) and map to Dolibarr User active flag. Eclipse security settings and authorization keys do not transfer and require reconfiguration in Dolibarr's permission system.

Gotchas + challenges

What specifically takes care here

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 logo

Epicor Eclipse gotchas

High

UniVerse MultiValue extraction requires non-standard tools

High

Performance degradation post-Kinetic migration

High

End-to-end workflow must be validated as a chain

Medium

Historical data scoping determines migration cost

Medium

Integration connections require separate migration planning

Dolibarr ERP logo

Dolibarr ERP gotchas

High

Foreign key constraint errors on cross-distribution database restore

High

SQL injection vulnerabilities in version 9.0.1

Medium

Custom fields stored as JSON in extraoptions require field-by-field deserialization

Medium

Decimal precision and rounding configuration affects price fields

Low

No native iOS/Android app forces reliance on browser

Pair-specific challenges

  • UniVerse MultiValue extraction requires non-standard tools

    Eclipse runs on Rocket UniVerse with file-based storage and PICK BASIC programming. Standard SQL connectors cannot read Eclipse data directly. We use Eclipse's REST API where available, supplemented by direct file extraction via Eterm connections or EDA exports. The Sales Order API specifically requires an additional license fee of $24,000 plus $4,000 setup per Reddit discussions among Eclipse users, which affects the extraction strategy. Dynamic arrays in Eclipse fields (such as multi-warehouse inventory quantities or customer ship-to addresses stored as multi-value fields) require custom parsing logic that we implement during the transformation phase. We flag any data locked in UniBASIC programs or user-defined dictionary fields that require manual extraction and review.

  • Eclipse pricing matrices do not export as standard fields

    Eclipse stores customer-specific pricing agreements (SPAs), quantity break tiers, promotional pricing rules, and substitute pricing in complex structures that are not standard database fields. These are embedded in UniBASIC programs or user-defined fields and require custom extraction logic. Dolibarr's pricing model supports standard prices, customer-specific prices, and quantity discounts, but it does not natively replicate Eclipse's full pricing matrix complexity. We flatten what we can into Dolibarr's price management system and flag any pricing rules that require manual configuration or third-party Dolibarr modules post-migration.

  • Counter/POS and RF scanning workflows have no native Dolibarr equivalent

    Eclipse includes built-in counter/POS for high-volume counter sales, RF product scanning for warehouse operations, and cross-docking workflows that are industry-specific. Dolibarr's stock module supports basic barcode scanning and stock movements but does not have a native POS interface or RF scanning module. We migrate the underlying transaction data (orders, inventory movements) but do not replicate the specialized counter/POS workflows. These require manual configuration in Dolibarr or a third-party POS/barcode module; we document the existing Eclipse workflows for the customer's team to reference during post-migration setup.

  • EDI configurations and trading partner enrollments do not transfer

    Eclipse EDI setups (trading partner IDs, document mapping, transmission protocols) are stored in Eclipse-specific EDI configuration tables and do not migrate to Dolibarr. Dolibarr does not have a native EDI module. We identify all active EDI connections during scoping and flag them as requiring re-enrollment with trading partners post-migration. This is a manual process that involves contacting each trading partner to set up new EDI credentials and document mappings. We provide a written inventory of all EDI connections with their configuration details so the customer's IT team can rebuild them.

  • Dolibarr database migration errors from version upgrades can affect the target

    Dolibarr's own database migration system (run during version upgrades) has known edge cases where table key counts exceed MySQL limits after cumulative updates, as reported on the Dolibarr community forum. We ensure the target Dolibarr installation is on a stable version before migration begins and avoid running Dolibarr version upgrades concurrently with data migration. If the customer is moving an existing Dolibarr installation (rather than a fresh install), we verify the database schema is clean before loading Eclipse data.

Migration approach

Six steps for a successful Epicor Eclipse to Dolibarr ERP data migration

  1. Discovery and Eclipse environment audit

    We audit the source Eclipse environment: current version (e.g., 9.x series), modules licensed and active (Order Management, Counter/POS, Inventory, Purchasing, Financials, CRM, Job Management, EDI), number of concurrent users, custom UniBASIC programs in use, and EDA dashboard configurations. We identify all integration endpoints (MES, quality tools, EDI, shipping, CRM) that will require re-establishment in Dolibarr. We review the Eclipse REST API availability and licensing status, noting that the Sales Order API requires an additional $24,000 license fee that affects extraction strategy. The discovery output is a written scope document covering data volumes, extraction method, historical data scope, and a list of integrations requiring post-migration attention.

  2. Extraction from Eclipse UniVerse

    We extract Eclipse data using the appropriate method based on the discovery findings. Where Eclipse REST API is licensed and available, we use standard endpoints for Customers, Suppliers, Products, Orders, and Inventory. For data not exposed via REST API, we use Eclipse's CSV export specifications (Mass Load utility) or direct UniVerse file extraction via Eterm connections with UniBASIC queries in RetrieVe query language. We parse dynamic arrays in Eclipse fields (multi-value address components, multi-warehouse quantities, product attribute arrays) into normalized columns during extraction. We run extraction during off-peak hours to avoid impacting Eclipse performance for active users.

  3. Dolibarr schema design and module activation

    We design the destination Dolibarr schema based on the migrated data. This includes activating the required Dolibarr modules: ThirdParty (for customers and suppliers), Product, Stock, CustomerOrder, SupplierOrder, Propal, Accounting, and any others needed. We configure the chart of accounts to match the customer's Eclipse account structure, set up tax rules per jurisdiction, define warehouse locations, and configure Dolibarr's price management system with the flattened pricing data from Eclipse. For distribution-specific configurations (counter/POS, RF scanning), we document the desired behavior and recommend appropriate Dolibarr modules or configuration steps for the customer's team to implement post-migration.

  4. Test migration and reconciliation

    We run a full test migration into a staging Dolibarr instance using representative data volumes. We reconcile record counts (customers in, suppliers in, products in, orders in, inventory values) against Eclipse source reports. We validate that open order totals match Eclipse balances, that inventory on-hand matches per warehouse, and that AR/AP aging matches Eclipse's ledger. The customer reviews the test migration data and confirms mapping accuracy before production migration begins. Any pricing matrix flattening issues, attribute mapping corrections, or account structure adjustments are resolved at this stage.

  5. Production migration in dependency order

    We run production migration in dependency order: ThirdParty records (customers and suppliers first), Products, Warehouses and stock levels, Open Customer Orders, Open Supplier Orders, Open AR/AP, Historical transactions (if scoped), and Tax rules. Each phase emits a reconciliation report comparing counts and totals to Eclipse source reports before the next phase begins. We use Dolibarr's native import tools or REST API based on volume; for large historical transaction sets, we batch inserts to stay within Dolibarr's processing limits. We freeze Eclipse writes during the final delta migration window to capture any records modified during the migration window.

  6. Cutover, validation, and handoff

    We validate the production migration end-to-end: customer and supplier counts, product counts, open order totals and line counts, inventory values per warehouse, AR/AP balances, and historical transaction totals. We run a sample of orders through Dolibarr end-to-end (from order entry to invoice to payment) to verify the workflow chain. We deliver the written automation inventory covering active UniBASIC programs, EDI configurations, and custom EDA dashboards that require redevelopment in Dolibarr. We provide a one-week hypercare window for reconciliation issues raised by the customer's team. We do not rebuild Eclipse workflows, EDI connections, or custom UniBASIC programs as part of the migration scope; those are documented for the customer's team to address separately.

Platform deep dives

Context on both ends of the pair

Epicor Eclipse logo

Epicor Eclipse

Source

Strengths

  • Specialized for wholesale distribution with counter/POS, cross-docking, RF scanning, and rebate tracking built in.
  • Strong multi-warehouse inventory management with bin locations, lot/serial tracking, and drop-ship capabilities.
  • Integrated financial management including AR/AP, credit management, and multi-currency for distributors.
  • Hot-key interface (F11) allows rapid data entry for high-volume counter sales environments.
  • Epicor Data Analytics (EDA) provides cloud-based dashboards and pre-built reports from Eclipse data.

Weaknesses

  • No true cloud-native version exists; organizations must move to Epicor Kinetic for cloud deployment.
  • UniVerse NoSQL database requires specialized extraction tools and transformation logic not needed for SQL-based ERPs.
  • Character-based green screen interface is dated and creates steep learning curve for new and remote users.
  • Limited analytics and reporting require custom development or third-party tools to achieve modern BI expectations.
  • Custom UniBASIC programs and EDA configurations do not migrate automatically and may require redevelopment.
Dolibarr ERP logo

Dolibarr ERP

Destination

Strengths

  • Free core software with AGPL license and no per-user mandatory fee for self-hosted deployments.
  • Modular architecture lets teams activate only needed features, keeping the interface focused and the database lean.
  • Self-hosted option provides full data sovereignty and avoids recurring SaaS subscription costs.
  • Built-in CSV/Excel import and export wizard with saved profiles simplifies recurring data operations.
  • Low-code Module Builder allows functional extensions without writing PHP code.

Weaknesses

  • No native documented REST API for programmatic bulk operations — all migrations depend on the import/export wizard or direct database access.
  • Reporting and analytics are weak without paid add-ons, and built-in charts are limited compared to modern SaaS platforms.
  • UI design is described as dated by multiple reviewers, with infrequent visual updates to the default theme.
  • Community-only support for self-hosted deployments means no SLA or guaranteed response time for issues.
  • Security vulnerabilities (CVE-2024-5314, CVE-2024-5315) in version 9.0.1 with no immediate patch reported.

Complexity grading

How hard is this migration?

Standard ERP migration. 2 of 8 objects need a mapping; the rest are 1:1.

B

Overall complexity

Standard migration

Derived from compatibility, mapping clarity, API constraints, and data volume across Epicor Eclipse and Dolibarr ERP.

  • Object compatibility

    B

    2 of 8 objects need a mapping; the rest are 1:1.

  • Field mapping clarity

    C

    Field mapping is derived from defaults — final spec confirmed during the sample migration.

  • Timeline complexity

    B

    8-object category — typical timelines run 2–7 days end-to-end.

  • API constraints

    B

    Epicor Eclipse: Rate limiting settings exist on the app server but are not publicly documented by Epicor.

  • Data volume sensitivity

    B

    Epicor Eclipse doesn't expose a bulk API — REST + parallelization used for high-volume runs.

Estimator

Estimate your Epicor Eclipse to Dolibarr ERP migration cost

Rule-based pricing — no per-record fees, no manual quotes. Migrations over 2M records are scoped individually.

Step 1

What are you migrating?

Pick a category, then your source and destination platforms.

Category

FAQ

Frequently asked questions about Epicor Eclipse to Dolibarr ERP data migrations

Answers to the questions buyers ask most during Epicor Eclipse to Dolibarr ERP migration scoping. Not seeing yours? Book a call.

Can't find your answer?

Walk through your Epicor Eclipse to Dolibarr ERP migration with a real engineer — 30 minutes, free, written quote within 24 hours.

Book a free 30 minute consultation

Most migrations land between five and eight weeks for distributors with under 10,000 parts, 2,000 customers, no custom UniBASIC programs, and scoped historical data. Projects with large pricing matrices, multi-warehouse inventory structures, active EDI configurations, or multi-year order history require twelve to eighteen weeks because of the extraction complexity, pricing matrix flattening, and EDI re-enrollment work. Discovery and scoping typically adds two to four weeks at the front end before any data moves.

Adjacent paths

Related migrations to explore

Ready when you are

Move from Epicor Eclipse.
Land in Dolibarr ERP, intact.

Tell us record counts and timeline. We'll come back with a written quote inside 1 business day — no commitment, no sales pitch.

Accuracy guarantee Rollback included Quote in 1 business day