ERP migration
Field-level mapping, validation, and rollback between Dolibarr ERP and Acumatica. We move data and schema; workflows are rebuilt natively in Acumatica.
Dolibarr ERP
Source
Acumatica
Destination
Compatibility
11 of 12
objects map 1:1 between Dolibarr ERP and Acumatica.
Complexity
BStandard
Timeline
3–7 days
Try the reverse
Overview
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.
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.
Source platform
Dolibarr ERP platform overview
Scorecard, SWOT, gotchas, and pricing for Dolibarr ERP.
Destination platform
Acumatica platform overview
Scorecard, SWOT, gotchas, and pricing for Acumatica.
Data migration guide
The complete Acumatica migration guide
Data model, import mechanisms, field mapping strategy, pitfalls, and cutover — by the engineers running it.
Source platform guide
Dolibarr migration guide
Understand the data you're exporting from Dolibarr ERP before mapping it.
Destination checklist
Acumatica migration checklist
Pre- and post-cutover tasks for moving onto Acumatica.
Source checklist
Dolibarr migration checklist
Exit checklist for unwinding your Dolibarr ERP setup cleanly.
Why teams make this switch
Leaving
What's pushing teams away
Choosing
What's pulling them in
Object mapping
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)
Acumatica
Customer + Vendor
1:manyDolibarr'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
Acumatica
CustomerContact
1:1Dolibarr 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
Acumatica
InventoryItem / NonStockItem / ServiceItem
1:1Dolibarr'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
Acumatica
Warehouse + INSite + INLocation
1:1Dolibarr 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)
Acumatica
SalesOrder / POOrder
1:1Dolibarr 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)
Acumatica
ARInvoice / APInvoice
1:1Dolibarr 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)
Acumatica
SalesQuote
1:1Dolibarr 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
Acumatica
PMProject + EPEmployeeTime
1:1Dolibarr 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
Acumatica
CRCase
1:1Support 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)
Acumatica
FSServiceOrder
1:1Dolibarr 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
Acumatica
Employee + User
1:1Dolibarr 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
Acumatica
Category + Tags
1:1Dolibarr 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.
| Dolibarr ERP | Acumatica | Compatibility | |
|---|---|---|---|
| Societe (ThirdParty) | Customer + Vendor1:many | Fully supported | |
| Contact | CustomerContact1:1 | Fully supported | |
| Product | InventoryItem / NonStockItem / ServiceItem1:1 | Fully supported | |
| Product.stock | Warehouse + INSite + INLocation1:1 | Fully supported | |
| Commande (Order) | SalesOrder / POOrder1:1 | Fully supported | |
| Facture (Invoice) | ARInvoice / APInvoice1:1 | Fully supported | |
| Propale (Proposal) | SalesQuote1:1 | Fully supported | |
| Project | PMProject + EPEmployeeTime1:1 | Fully supported | |
| Ticket | CRCase1:1 | Fully supported | |
| Fichinter (Intervention) | FSServiceOrder1:1 | Fully supported | |
| User | Employee + User1:1 | Fully supported | |
| Category | Category + Tags1: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.
Dolibarr ERP gotchas
Foreign key constraint errors on cross-distribution database restore
SQL injection vulnerabilities in version 9.0.1
Custom fields stored as JSON in extraoptions require field-by-field deserialization
Decimal precision and rounding configuration affects price fields
No native iOS/Android app forces reliance on browser
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
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.
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.
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.
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.
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
Dolibarr ERP
Source
Strengths
Weaknesses
Acumatica
Destination
Strengths
Weaknesses
Complexity grading
Standard ERP migration. 1 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 Dolibarr ERP and Acumatica.
Object compatibility
1 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
Dolibarr ERP: Not publicly documented.
Data volume sensitivity
Dolibarr ERP 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 Dolibarr ERP to Acumatica migration scoping. Not seeing yours? Book a call.
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 consultationAdjacent paths
Other ways to leave Dolibarr ERP
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.