ERP migration

Migrate from Dolibarr ERP to Acumatica

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

Dolibarr ERP logo

Dolibarr ERP

Source

Acumatica

Destination

Acumatica logo

Compatibility

92%

11 of 12

objects map 1:1 between Dolibarr ERP and Acumatica.

Complexity

BStandard

Timeline

3–7 days

Rollback included Accuracy guarantee Field-level validation

Try the reverse

Acumatica
Dolibarr ERP

Overview

What this migration involves

Dolibarr ERP stores its data in a flat relational structure optimized for small-business simplicity: a single products table handles goods, services, and non-stock items; a unified third-party record serves as both customer and supplier; and projects store all work, tasks, and time without a separate project-costing layer. Acumatica uses a deeper relational schema with mandatory fiscal periods (FinPeriodID on every transaction), separate Customer and Vendor records keyed by class, and inventory items split into StockItem, NonStockItem, and ServiceItem types. The migration extracts Dolibarr data via its REST API or direct database query, transforms the structural differences (third-party split, product-type routing, period assignment, document-type demultiplexing), and loads through Acumatica's Import by Scenario screens. A 24–48 hour delta window captures any in-flight records modified during the cutover. Workflows, triggers, email templates, and scheduled actions do not transfer — these are rebuilt in Acumatica's Automation Screens and notification framework post-migration. The transformation layer also handles currency conversion, tax zone mapping, and GL account routing based on document type and partner class.

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

Dolibarr ERP logo

Dolibarr ERP

What's pushing teams away

  • Dated, utilitarian UI with infrequent visual updates frustrates teams expecting modern design from SaaS alternatives.
  • Reporting and analytics capabilities are weak out of the box, requiring paid modules or custom SQL work to get meaningful dashboards.
  • Critical SQL injection vulnerabilities disclosed in version 9.0.1 with no immediate patch made some teams reconsider their exposure.
  • Community support only — no official SLA or paid support tier for self-hosted deployments creates risk for businesses needing guaranteed response times.
  • Feature gaps in financial workflows like payment release, margin reports, and multi-currency precision cause teams with complex accounting needs to migrate.

Choosing

Acumatica logo

Acumatica

What's pulling them in

  • Unlimited user licensing lets companies add staff without per-seat billing shocks, making Acumatica cost-predictable at scale.
  • Flexibility and scalability earn consistent praise — users value a platform that adapts to vertical workflows without forcing a redesign.
  • Real-time visibility across financials, inventory, and projects gives mid-market businesses a consolidated operational view previously available only in enterprise-tier ERPs.
  • Cloud-native architecture with automatic updates removes infrastructure management burden from in-house IT teams.
  • Modular licensing lets companies start with one or two suites (Financials, Distribution) and expand into Manufacturing or CRM incrementally.

Object mapping

How Dolibarr ERP objects map to Acumatica

Each row shows how a Dolibarr ERP 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.

Dolibarr ERP

Societe (ThirdParty)

maps to

Acumatica

Customer + Vendor

1:many
Fully supported

Dolibarr's single third-party record carries both customer and supplier data. The migration splits this into separate Acumatica Customer and Vendor records keyed by CustomerClassID and VendorClassID. Classification records must exist in Acumatica before the import runs; any Dolibarr third-party without a type flag creates a Customer record only by default.

Dolibarr ERP

Contact

maps to

Acumatica

CustomerContact

1:1
Fully supported

Dolibarr contacts map to CustomerContact in Acumatica, linked via CustomerID. Multiple addresses per third-party in Dolibarr become separate Address records in Acumatica with individual AddressID values. The primary contact flag maps to the IsPrimaryContact checkbox. Secondary contacts attach with IsPrimaryContact cleared. Email and phone fields transfer directly; job title maps to the Title field on the contact record.

Dolibarr ERP

Product

maps to

Acumatica

InventoryItem / NonStockItem / ServiceItem

1:1
Fully supported

Dolibarr's single products table routes to different Acumatica item types based on the product_type field: 'product' with stock tracking becomes StockItem (with StockItemMaint and Bill of Materials if applicable), 'service' becomes ServiceItem, and products without stock management become NonStockItem. ItemClassID mapping requires pre-created item classes in Acumatica.

Dolibarr ERP

Product.stock

maps to

Acumatica

Warehouse + INSite + INLocation

1:1
Fully supported

Dolibarr warehouse stock records map to Acumatica warehouse sites (INSite) and bin locations (INLocation). The physical quantity and reserved quantity fields transfer as OnHandQty and AvailableQty respectively. Multi-warehouse Dolibarr setups require corresponding site creation in Acumatica before stock loads. Bin-level transfers in Dolibarr map to INLocation records linked to the target warehouse site.

Dolibarr ERP

Commande (Order)

maps to

Acumatica

SalesOrder / POOrder

1:1
Fully supported

Dolibarr distinguishes customer orders from supplier orders by the order's sjointype field. Customer orders map to SalesOrder (with SOOrderType and status routing); supplier orders map to POOrder. The doc_date field maps to OrderDate and must fall within an open FinPeriod for the order to be saved. Order total maps to CuryLineTotal with tax handled separately.

Dolibarr ERP

Facture (Invoice)

maps to

Acumatica

ARInvoice / APInvoice

1:1
Fully supported

Dolibarr customer invoices map to ARInvoice (with DocType=INV); supplier invoices map to APInvoice (DocType=INV). The invoice_date and due_date fields map to DocDate and DueDate respectively, both requiring an open FinPeriod. Line items carry ProductID, CuryUnitCost, and Qty, with DiscPct handling early-payment discounts. DocNumber preserves the Dolibarr ref as ReferenceNbr for traceability.

Dolibarr ERP

Propale (Proposal)

maps to

Acumatica

SalesQuote

1:1
Fully supported

Dolibarr commercial proposals migrate to SalesQuote in Acumatica. The status lifecycle (draft, validated, signed, notsigned, closed) maps to Acumatica's SalesQuote status workflow. Quote lines carry the same product, quantity, and pricing structure as order lines. Expiration dates transfer as ExpirationDate on the quote header.

Dolibarr ERP

Project

maps to

Acumatica

PMProject + EPEmployeeTime

1:1
Fully supported

Dolibarr projects map to PMProject with ProjectID, Description, CustomerID (lookup to Customer record), status, and date fields. Tasks map to PMTask under each project. Time entries and expenses become EPEmployeeTime entries linked to the project task. Project cost budget tracking uses PMBudget, which requires Acumatica's Project Accounting license tier.

Dolibarr ERP

Ticket

maps to

Acumatica

CRCase

1:1
Fully supported

Support tickets in Dolibarr map to CRCase in Acumatica's CRM module. The ticket subject, description, and creation date transfer as CaseCD, Subject, Description, and CreatedDateTime respectively. Resolution notes map to the case's internal notes field. Priority maps to CaseClassID and Severity field in Acumatica's case management.

Dolibarr ERP

Fichinter (Intervention)

maps to

Acumatica

FSServiceOrder

1:1
Fully supported

Dolibarr interventions map to FSServiceOrder in Acumatica's Field Service module (if licensed). The intervention date, duration, description, and linked third-party and contact transfer to service order fields. Billable flag maps to Billable and CuryUnitPrice; non-billable interventions carry zero price. Without the Field Service license, interventions migrate as Case records with a custom intervention flag.

Dolibarr ERP

User

maps to

Acumatica

Employee + User

1:1
Fully supported

Dolibarr users map to Acumatica Employee records with the same login email. The employee record is created first, then the Acumatica user account is linked with the EmployeeID. Active/inactive status maps from Dolibarr's user active flag. Branch assignments in Acumatica require HR structure setup before users can be assigned to locations.

Dolibarr ERP

Category

maps to

Acumatica

Category + Tags

1:1
Fully supported

Dolibarr product and third-party categories map to Acumatica's Category entity linked by entity class. Multi-level Dolibarr categories (parent/child) preserve the hierarchy in Acumatica's CategoryTree structure. Contact categories transfer as Tags on the CustomerContact record for filtering in CRM screens. The CategoryTree ensures parent-child relationships display correctly in Acumatica's reporting and filtering interfaces.

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.

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

Acumatica logo

Acumatica gotchas

High

API user licenses cap concurrent sessions and request throughput

High

Multi-tenant filtering requires CompanyID awareness

Medium

Custom fields require separate discovery before field mapping

Medium

Notes and attachments use a separate linked table structure

Low

Implementation timelines frequently run 3–9 months end-to-end

Pair-specific challenges

  • Third-party split creates duplicate or missing Customer/Vendor records

    Dolibarr's single third-party record serves as both customer and supplier depending on the type flag, while Acumatica maintains separate Customer (BAccountID) and Vendor (VendorID) entities. The migration must split each Dolibarr third-party into one or two Acumatica records based on the isclient and isfournisseur flags. Acumatica enforces referential integrity on CustomerClassID and VendorClassID — if the classification records don't exist in Acumatica, the import fails. We pre-create the required class records and route each third-party to its correct entity before loading.

  • Fiscal period enforcement blocks transactions outside open periods

    Dolibarr has no fiscal period concept — any invoice or order date is accepted regardless of month-close status. Acumatica's general ledger requires every transaction (ARInvoice, APInvoice, SalesOrder) to carry a valid FinPeriodID corresponding to an open accounting period. Transactions whose doc_date falls in a closed period are rejected by Acumatica's validation logic. The migration plan must open the necessary fiscal periods before loading, and we map each document date to the nearest open period with a discrepancy log for finance-team review.

  • Product type routing requires pre-loaded item classes

    Dolibarr's products table uses a single type field to distinguish goods from services and controls stock tracking, but Acumatica splits these into distinct tables (StockItem for tracked inventory, NonStockItem for non-inventoried goods, ServiceItem for labor and intangibles). The migration must examine each Dolibarr product's type and stock_management flag to determine the correct Acumatica item type before loading. ItemClassID on each item is mandatory in Acumatica — we pre-create item class records matching Dolibarr's product categories so each item can be assigned on import.

  • Document-type demultiplexing requires separate numbering sequences

    Dolibarr stores customer orders, supplier orders, quotes, customer invoices, and supplier invoices in separate tables (Commande, Propale, Facture) with their own numbering sequences. Acumatica models these as separate document entities (SalesOrder, SalesQuote, ARInvoice, POOrder, APInvoice) each with independent numbering sequences defined in the document type screens (SO201000, QU201000, AR301000). The migration plan maps each Dolibarr document type to its corresponding Acumatica entity and must pre-create the numbering sequence before the import runs — otherwise Acumatica rejects the record with a sequence-required error.

  • API rate limits constrain export throughput for large datasets

    Acumatica's license enforces a maximum of 100 web services API requests per minute per instance, as documented in the License Monitoring Console (SM604000). Dolibarr's REST API can return large result sets but the migration pipeline must implement throttling and exponential backoff when writing to Acumatica to avoid license violations. Datasets above 50,000 records require batch processing with cursor-based pagination; we configure the extraction pipeline to respect the 100 req/min ceiling and log any throttling events for audit.

Migration approach

Six steps for a successful Dolibarr ERP to Acumatica data migration

  1. Profile Dolibarr data and define Acumatica target schema

    We connect to your Dolibarr instance via REST API or direct database read to inventory all active records: third parties, contacts, products, stock levels, orders, invoices, proposals, projects, tasks, tickets, and any ExtraFields. The output is a data-profiling report showing record counts per entity, custom field inventory, and the Dolibarr modules you have enabled. Simultaneously, we document the Acumatica target schema based on your licensed modules (Financials, Distribution, Project Accounting, CRM, Field Service) and identify which Acumatica entity classes, numbering sequences, and fiscal periods need to exist before data loads.

  2. Design object and field mapping with transformation logic

    The object mapping translates Dolibarr entities to their Acumatica equivalents, with explicit handling of the split (third-party to Customer+Vendor), transformed (product to item type), and merged (multi-address Dolibarr contacts to per-contact address records) cases identified in the gotcha analysis. Field-level mapping names the exact source column and destination field for every data element, including ExtraFields mapped to custom DAC attributes. We deliver a mapping specification document for your review before any code runs.

  3. Build Acumatica master data skeleton and custom attributes

    Acumatica requires its classification hierarchy — item classes, customer and vendor classes, GL accounts, tax zones, and numbering sequences — to exist before transactional data can reference them. We create these records in a sandbox Acumatica tenant first using Acumatica's Import by Scenario tool. Custom fields defined in Dolibarr ExtraFields are created as DAC extension attributes in Acumatica's customization project framework with matching data types (string, integer, date, pick-list). This step produces a validated skeleton that accepts the data without constraint violations.

  4. Extract, clean, and transform Dolibarr data

    The migration pipeline extracts Dolibarr records via REST API or database query, applies cleaning rules (duplicate detection on third-party email, address standardization, date-format normalization), and runs the transformation logic per the mapping specification. Structural transformations include third-party type-based splitting, product-type routing to Acumatica item types, FinPeriodID derivation for every transaction date, and document-type routing to Acumatica's separate order and invoice entities. Attachments stored in Dolibarr's file system are downloaded and queued for re-upload to Acumatica's NoteDoc storage.

  5. Load into Acumatica and run delta-pickup window

    We load data into Acumatica through Import by Scenario screens in dependency order: first classes and accounts, then customers and vendors, then inventory items, then contacts and addresses, then transactional documents (orders, invoices, quotes), then projects and tasks, then tickets and interventions. A 24–48 hour delta-pickup window opens at cutover to capture any records created or modified in Dolibarr during the migration run. All operations are logged to an audit table; one-click rollback reverts the Acumatica tenant to its pre-migration state if reconciliation uncovers critical discrepancies.

Platform deep dives

Context on both ends of the pair

Dolibarr ERP logo

Dolibarr ERP

Source

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.
Acumatica logo

Acumatica

Destination

Strengths

  • Unlimited named-user licensing eliminates per-seat cost scaling as teams grow.
  • Modular architecture lets companies deploy Financials first and add Distribution, Manufacturing, or CRM incrementally.
  • Cloud-native with automatic updates removes infrastructure patching and version management from IT responsibilities.
  • Flexible customization framework (UDFs, extensions) supports vertical-specific workflows without forking core code.
  • Multi-tenant architecture with CompanyID isolation enables safe data segregation across subsidiaries.

Weaknesses

  • Steep learning curve and complex initial setup create significant onboarding friction.
  • Report Designer is widely cited as unintuitive and difficult to use for non-developers.
  • Feature gaps require customizations or third-party add-ons, adding implementation cost and complexity.
  • Implementation timelines frequently exceed initial estimates, especially for multi-module deployments.
  • API rate limits and concurrent session caps are tied to license tier, creating throughput constraints for bulk data operations.

Complexity grading

How hard is this migration?

Standard ERP migration. 1 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 Dolibarr ERP and Acumatica.

  • Object compatibility

    B

    1 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

    Dolibarr ERP: Not publicly documented.

  • Data volume sensitivity

    B

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

Estimator

Estimate your Dolibarr ERP to Acumatica 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 Dolibarr ERP to Acumatica data migrations

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

Can't find your answer?

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

Book a free 30 minute consultation

Most Dolibarr-to-Acumatica migrations complete within 3–7 days for setups with fewer than 50,000 records and fewer than 30 ExtraFields. Larger migrations involving multiple Dolibarr installations, complex project-costing structures, or high-volume attachment processing extend to 2–4 weeks. The longest step is Acumatica schema setup — creating item classes, customer classes, GL accounts, and numbering sequences — because Acumatica enforces referential integrity before data can land.

Adjacent paths

Related migrations to explore

Ready when you are

Move from Dolibarr ERP.
Land in Acumatica, 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